Customers

Get customer

Get a customer by ID or key.

get/api/v1/customers/{customerIdOrKey}

Request

Base URL
https://openmeter.cloud (the document declares no server; this is the origin it was published from)
Auth
- HTTP bearer
- or API key in cookie __session

Path parameters

string required

ULID (Universally Unique Lexicographically Sortable Identifier).

string required

ExternalKey is a looser version of key.

Example:01G65Z755AFWAKHE12NY0CQ9FH

Query parameters

expandCustomerExpand[]

What parts of the customer output to expand

Response

The request has succeeded.

annotationsAnnotations

Set of key-value pairs managed by the system. Cannot be modified by user.

createdAtstring date-time required

Timestamp of when the resource was created.

currencystring

Three-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.

currentSubscriptionIdstring

The ID of the Subscription if the customer has one.

deletedAtstring date-time

Timestamp of when the resource was permanently deleted.

descriptionstring

Optional description of the resource. Maximum 1024 characters.

idstring required

A unique identifier for the resource.

keystring

An optional unique key of the customer. Either key or usageAttribution.subjectKeys must be provided. Useful to reference the customer in external systems. For example, your database ID.

metadataMetadata

Set of key-value pairs. Metadata can be used to store additional information about a resource.

namestring required

Human-readable name for the resource. Between 1 and 256 characters.

primaryEmailstring

The primary email address of the customer.

updatedAtstring date-time required

Timestamp of when the resource was last updated.

Example response

{
  "createdAt": "2024-01-01T01:01:01.001Z",
  "id": "01G65Z755AFWAKHE12NY0CQ9FH",
  "name": "ACME Inc.",
  "updatedAt": "2024-01-01T01:01:01.001Z",
  "usageAttribution": {
    "subjectKeys": [
      "my_subject_key"
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.