> ## Documentation Index > Fetch the complete documentation index at: https://polar.sh/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get Customer Meter > Get a meter by ID for the authenticated customer. **Scopes**: `customer_portal:read` `customer_portal:write` ## OpenAPI ````yaml /openapi/2027-01.openapi.json get /v1/customer-portal/meters/{id} openapi: 3.1.0 info: title: Polar API summary: Polar HTTP and Webhooks API description: >- Read the docs at https://polar.sh/docs/api-reference. See https://polar.sh/docs/api-reference/versioning for the API versioning and deprecation policy. version: 2027-01 servers: - url: https://api.polar.sh description: Production environment x-speakeasy-server-id: production x-polar-environment: production - url: https://sandbox-api.polar.sh description: Sandbox environment x-speakeasy-server-id: sandbox x-polar-environment: sandbox security: [] tags: - name: public description: >- Endpoints shown and documented in the Polar API documentation and available in our SDKs. - name: private description: >- Endpoints that should appear in the schema only in development to generate our internal JS SDK. - name: mcp description: Endpoints supported by Polar's MCP server. - name: cli description: Endpoints exposed as commands by Polar's CLI. externalDocs: description: API versioning and deprecation policy url: https://polar.sh/docs/api-reference/versioning paths: /v1/customer-portal/meters/{id}: get: tags: - customer_portal - customer_meters - public summary: Get Customer Meter description: |- Get a meter by ID for the authenticated customer. **Scopes**: `customer_portal:read` `customer_portal:write` operationId: customer_portal:customer_meters:get parameters: - name: id in: path required: true schema: type: string format: uuid4 description: The customer meter ID. title: Id description: The customer meter ID. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CustomerCustomerMeter' '404': description: Customer meter not found. content: application/json: schema: $ref: '#/components/schemas/ResourceNotFound' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - customer_session: - customer_portal:read - customer_portal:write - member_session: - customer_portal:read - customer_portal:write x-codeSamples: - lang: python source: | from polar.v2027_01 import Polar polar = Polar("polar_oat_xxx") response = polar.customer_portal.customer_meters.get( '00000000-0000-4000-8000-000000000000', ) print(response) - lang: typescript source: | import { createPolar } from "@polar-sh/sdk/2027-01"; const polar = createPolar({ accessToken: "polar_oat_xxx", }); const response = await polar.customerPortal.customerMeters.get( "00000000-0000-4000-8000-000000000000", ); console.log(response); components: schemas: CustomerCustomerMeter: properties: id: type: string format: uuid4 title: Id description: The ID of the object. created_at: type: string format: date-time title: Created At description: Creation timestamp of the object. examples: - '2026-01-01T00:00:00.000000Z' modified_at: anyOf: - type: string format: date-time examples: - '2026-01-01T00:00:00.000000Z' - type: 'null' title: Modified At description: Last modification timestamp of the object. customer_id: type: string format: uuid4 title: Customer Id description: The ID of the customer. examples: - 992fae2a-2a17-4b7a-8d9e-e287cf90131b meter_id: type: string format: uuid4 title: Meter Id description: The ID of the meter. examples: - d498a884-e2cd-4d3e-8002-f536468a8b22 consumed_units: type: number title: Consumed Units description: The number of consumed units. examples: - 25 credited_units: type: integer title: Credited Units description: The number of credited units. examples: - 100 balance: type: number title: Balance description: >- The balance of the meter, i.e. the difference between credited and consumed units. examples: - 75 meter: $ref: '#/components/schemas/CustomerCustomerMeterMeter' type: object required: - id - created_at - modified_at - customer_id - meter_id - consumed_units - credited_units - balance - meter title: CustomerCustomerMeter ResourceNotFound: properties: error: type: string const: ResourceNotFound title: Error examples: - ResourceNotFound detail: type: string title: Detail type: object required: - error - detail title: ResourceNotFound HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CustomerCustomerMeterMeter: properties: created_at: type: string format: date-time title: Created At description: Creation timestamp of the object. examples: - '2026-01-01T00:00:00.000000Z' modified_at: anyOf: - type: string format: date-time examples: - '2026-01-01T00:00:00.000000Z' - type: 'null' title: Modified At description: Last modification timestamp of the object. id: type: string format: uuid4 title: Id description: The ID of the object. name: type: string title: Name description: >- The name of the meter. Will be shown on customer's invoices and usage. type: object required: - created_at - modified_at - id - name title: CustomerCustomerMeterMeter ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: customer_session: type: http description: >- Customer session tokens are specific tokens that are used to authenticate customers on your organization. You can create those sessions programmatically using the [Create Customer Session endpoint](/api-reference/customer-sessions/create-customer-session). scheme: bearer member_session: type: http description: >- Member session tokens are specific tokens that are used to authenticate members on your organization. You can create those sessions programmatically using the [Create Member Session endpoint](/api-reference/customer-sessions/create-customer-session). scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.