Skip to content
Trustaige Docs
API reference

Customer credentials

List subjects

get /o/{shortId}/api/credentials/subjects

The customers your app has made offers to, newest first. Another app's customers are never included.

Authentication

A client token (Authorization: Bearer …) from POST /oauth2/token with the scope issued:read .

Path parameters

  • shortId string required

    Your organization's short ID, as it appears in your issuer: https://id.trustaige.com/o/{shortId}.

Query parameters

  • claimed string

    Only customers who have (true) or haven't (false) claimed a credential.

    One of true , false

  • limit integer 1–200default 50

    How many to return.

  • next_page_token string

    The nextPageToken from the previous page.

Responses

  • 200 A page of subjects.
    Show response fields
    • items array of object required

      Newest first.

      Show child attributes
      • subject string · uuid required

        The customer.

      • claimed boolean required

        Whether the customer has claimed a credential.

      • credentials integer required

        Credentials issued to the customer, in any state.

      • live integer required

        Credentials currently live.

      • openOffers integer required

        Offers still waiting to be claimed.

      • lastIssuedAt string · date-time

        When a credential was last issued to the customer.

      • createdAt string · date-time required

        When you first offered to this customer.

    • hasMore boolean required

      Whether another page follows.

    • nextPageToken string

      Pass as next_page_token for the next page. Present when hasMore is true.

  • 401 No bearer token.
  • 403 The token belongs to another organization.

Errors

Errors come back as a code to branch on. What each means and what to do:

Status Code What to do
403 wrong_organization The token belongs to another organization's app. Use your own organization's short ID.