Fetch a Customer's identity details

Get detailed information about a customers identity. This is used to construct ID tokens. Data in the response will only be shared to clients if the client requested the appropriate claim or scope. For details on how the values are used by clients, refer to the Open ID Connect standard claims

GET /auth/v1/customer/{customerId}

Fetch a customer's identity details

cURL

curl --request GET \
  --url https://api.provider.fiskil.com/auth/v1/customer/{customerId} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "customerid",
  "email": "[e-mail]",
  "emailVerified": true,
  "familyName": "Sherman",
  "givenName": "Peter",
  "name": "Peter Sherman",
  "phoneNumber": "[phone]",
  "phoneNumberVerified": true,
  "updatedAt": "2025-07-01T00:00:00Z",
  "address": {
    "streetAddress": "42 Wallaby Way",
    "locality": "Sydney",
    "region": "NSW",
    "postalCode": "2000",
    "country": "AUS"
  }
}

Authorizations

Authorization · string · header · required

The Fiskil Data Provider will include a self-signed JWT as a Bearer token in the Authorization header. You should verify this JWT using the JWKS URL you can find for your Data Provider instance in the Fiskil Console. To verify the JWT you must:

• Verify the signature
• Ensure the token has not expired by checking the exp claim
• The sub and iss claims are your data provider subdomain
• The aud claim is the URI of the resource being requested (excluding any query parameters)
• The jti value is unique For further detail on security and authentication refer to our Authentication documentation

Path Parameters

customerId · string · required

ID of a customer

Response

200

application/json

Map of identifying details for the customer

id · string

ID of the customer.

email · string

The customer's contact email address

emailVerified · boolean

A flag indicating that some verification has been done to prove the customer owns the email

familyName · string

The customer's family name

givenName · string

The customer's given name (or names)

name · string

A descriptive name for the customer that is suitable for display in user interfaces

phoneNumber · string

Customer's preferred telephone number in E.164 format e.g. [phone]. For details of the E.164 format see https://www.itu.int/rec/T-REC-E.164/en.

phoneNumberVerified · boolean

A flag indicating that some verification has been done to prove the customer owns the phone number

updatedAt · string

An RFC3339 timestamp for when the customer information was most recently set

address · object

The customer's physical address. Return only as much information as you have available. Refer to the Open ID address claim for details on each field.

Show child attributes