Get Customer by ID

curl --request GET \
  --url https://app.lukittu.com/api/v1/dev/teams/{teamId}/customers/{customerId} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "789e0123-e89b-12d3-a456-426614174222",
    "email": "[email protected]",
    "fullName": "John Doe",
    "username": "johndoe",
    "metadata": [
      {
        "key": "tier",
        "value": "premium",
        "locked": false
      }
    ],
    "address": {
      "street": "123 Main St",
      "city": "Anytown",
      "state": "CA",
      "country": "US",
      "postalCode": "12345"
    },
    "discordAccount": {
      "id": "111e2222-e89b-12d3-a456-426614174999",
      "customerId": "789e0123-e89b-12d3-a456-426614174222",
      "discordId": "123456789012345678",
      "username": "johndoe_discord",
      "avatar": "a1b2c3d4e5f6g7h8i9j0",
      "createdAt": "2023-09-15T14:30:00Z",
      "updatedAt": "2023-09-15T14:30:00Z"
    },
    "teamId": "123e4567-e89b-12d3-a456-426614174000",
    "createdByUserId": "456e7890-e89b-12d3-a456-426614174111",
    "createdAt": "2023-09-15T14:30:00Z",
    "updatedAt": "2023-09-15T14:30:00Z"
  },
  "result": {
    "timestamp": "2023-09-15T14:30:00Z",
    "valid": true,
    "details": "Customer found"
  }
}

GET

api

dev

teams

{teamId}

customers

{customerId}

Get Customer by ID

curl --request GET \
  --url https://app.lukittu.com/api/v1/dev/teams/{teamId}/customers/{customerId} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "789e0123-e89b-12d3-a456-426614174222",
    "email": "[email protected]",
    "fullName": "John Doe",
    "username": "johndoe",
    "metadata": [
      {
        "key": "tier",
        "value": "premium",
        "locked": false
      }
    ],
    "address": {
      "street": "123 Main St",
      "city": "Anytown",
      "state": "CA",
      "country": "US",
      "postalCode": "12345"
    },
    "discordAccount": {
      "id": "111e2222-e89b-12d3-a456-426614174999",
      "customerId": "789e0123-e89b-12d3-a456-426614174222",
      "discordId": "123456789012345678",
      "username": "johndoe_discord",
      "avatar": "a1b2c3d4e5f6g7h8i9j0",
      "createdAt": "2023-09-15T14:30:00Z",
      "updatedAt": "2023-09-15T14:30:00Z"
    },
    "teamId": "123e4567-e89b-12d3-a456-426614174000",
    "createdByUserId": "456e7890-e89b-12d3-a456-426614174111",
    "createdAt": "2023-09-15T14:30:00Z",
    "updatedAt": "2023-09-15T14:30:00Z"
  },
  "result": {
    "timestamp": "2023-09-15T14:30:00Z",
    "valid": true,
    "details": "Customer found"
  }
}

Authorizations

Authorization

string

header

required

API key authentication for development endpoints.

You can create API keys in your team's settings on the Lukittu dashboard. Include the API key in the Authorization header as: Bearer YOUR_API_KEY

Example:

Authorization: Bearer lukittu_api_key_abc123def456...

Path Parameters

teamId

string<uuid>

required

Your team's UUID. You can find this value in your team's settings on the Lukittu dashboard. UUID v4 identifier

customerId

string<uuid>

required

The unique identifier (UUID v4) of the customer. UUID v4 identifier

Response

Customer found successfully

data

object

required

Response data

Show child attributes

data.id

string<uuid>

required

Unique customer identifier

data.teamId

string<uuid>

required

Team that owns this customer

data.createdByUserId

string<uuid>

required

User who created this customer record

data.createdAt

string<date-time>

required

Customer record creation timestamp

data.updatedAt

string<date-time>

required

Customer record last update timestamp

data.email

string<email> | null

Customer email address

data.fullName

string | null

Customer full name

data.username

string | null

Customer username

data.metadata

object[]

Key-value metadata pairs

Show child attributes

data.metadata.key

string

required

Metadata key

data.metadata.value

string

required

Metadata value

data.metadata.locked

boolean

required

Whether this metadata field is locked from client modification

data.address

object

Customer address information

Show child attributes

data.address.street

string | null

Street address

data.address.city

string | null

City

data.address.state

string | null

State or province

data.address.country

string | null

Country

data.address.postalCode

string | null

Postal or ZIP code

data.discordAccount

object

Associated Discord account information

Show child attributes

data.discordAccount.id

string<uuid>

required

Discord account record ID

data.discordAccount.customerId

string<uuid>

required

Associated customer ID

data.discordAccount.discordId

string

required

Discord user ID (snowflake)

data.discordAccount.username

string

required

Discord username

data.discordAccount.createdAt

string<date-time>

required

Discord account record creation timestamp

data.discordAccount.updatedAt

string<date-time>

required

Discord account record last update timestamp

data.discordAccount.avatar

string | null

Discord avatar hash (null if no custom avatar)

result

object

required

Show child attributes

result.timestamp

string<date-time>

required

Timestamp when the response was generated

result.valid

enum<boolean>

required

Indicates whether the operation was successful Always true for success responses

Available options:

true,

false

result.details

string

required

Human-readable description of the result

Create Customer Update Customer

⌘I

API Documentation

Client - Verify

Dev - Licenses

Dev - Customers

Get Customer by ID

Authorizations

Path Parameters

Response