Identities

Server

Federated identities.

List identities

GET

https://api.cineamo.com

/identities

Returns a list of Identity objects.

List identities › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

tenantId

string

sourceTypes

string[]

consentStatuses

string[]

List identities › Responses

Identity list

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Create an identity

POST

https://api.cineamo.com

/identities

Creates an Identity. It returns the Identity object.

Create an identity › Request Body

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Create an identity › Responses

Identity was created

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

POST/identities

curl https://api.cineamo.com/identities \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tenantId": "550e8400-e29b-41d4-a716-446655440001",
  "sourceType": "website",
  "anonymousId": "anon-abc123",
  "consentStatus": "unknown",
  "userId": "user-123",
  "mergedIntoId": "550e8400-e29b-41d4-a716-446655440002",
  "firstSeenAt": "2026-03-05T12:00:00Z",
  "lastSeenAt": "2026-03-05T12:00:00Z"
}'

Example Request Body

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tenantId": "550e8400-e29b-41d4-a716-446655440001",
  "sourceType": "website",
  "anonymousId": "anon-abc123",
  "consentStatus": "unknown",
  "userId": "user-123",
  "mergedIntoId": "550e8400-e29b-41d4-a716-446655440002",
  "firstSeenAt": "2026-03-05T12:00:00Z",
  "lastSeenAt": "2026-03-05T12:00:00Z"
}

json

Example Responses

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tenantId": "550e8400-e29b-41d4-a716-446655440001",
  "sourceType": "website",
  "anonymousId": "anon-abc123",
  "consentStatus": "unknown",
  "userId": "user-123",
  "mergedIntoId": "550e8400-e29b-41d4-a716-446655440002",
  "firstSeenAt": "2026-03-05T12:00:00Z",
  "lastSeenAt": "2026-03-05T12:00:00Z"
}

json

application/json

Get an identity

GET

https://api.cineamo.com

/identities/{identityId}

Returns an Identity object by its Id.

Get an identity › path Parameters

identityId

string · required

Get an identity › Responses

Identity details

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Delete an identity

DELETE

https://api.cineamo.com

/identities/{identityId}

Deletes an Identity. It returns an empty response.

Delete an identity › path Parameters

identityId

string · required

Delete an identity › Responses

Identity was deleted

No data returned

Update an identity

PATCH

https://api.cineamo.com

/identities/{identityId}

Updates an Identity. It returns the updated Identity object.

Update an identity › path Parameters

identityId

string · required

Update an identity › Request Body

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Update an identity › Responses

200

Identity was updated

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

PATCH/identities/{identityId}

curl https://api.cineamo.com/identities/:identityId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tenantId": "550e8400-e29b-41d4-a716-446655440001",
  "sourceType": "website",
  "anonymousId": "anon-abc123",
  "consentStatus": "unknown",
  "userId": "user-123",
  "mergedIntoId": "550e8400-e29b-41d4-a716-446655440002",
  "firstSeenAt": "2026-03-05T12:00:00Z",
  "lastSeenAt": "2026-03-05T12:00:00Z"
}'

Example Request Body

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tenantId": "550e8400-e29b-41d4-a716-446655440001",
  "sourceType": "website",
  "anonymousId": "anon-abc123",
  "consentStatus": "unknown",
  "userId": "user-123",
  "mergedIntoId": "550e8400-e29b-41d4-a716-446655440002",
  "firstSeenAt": "2026-03-05T12:00:00Z",
  "lastSeenAt": "2026-03-05T12:00:00Z"
}

json

Example Responses

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tenantId": "550e8400-e29b-41d4-a716-446655440001",
  "sourceType": "website",
  "anonymousId": "anon-abc123",
  "consentStatus": "unknown",
  "userId": "user-123",
  "mergedIntoId": "550e8400-e29b-41d4-a716-446655440002",
  "firstSeenAt": "2026-03-05T12:00:00Z",
  "lastSeenAt": "2026-03-05T12:00:00Z"
}

json

application/json

Current User (Me)Movie Lists

List identities

GET

https://api.cineamo.com

/identities

Returns a list of Identity objects.

List identities › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

tenantId

string

sourceTypes

string[]

consentStatuses

string[]

List identities › Responses

Identity list

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Create an identity

POST

https://api.cineamo.com

/identities

Creates an Identity. It returns the Identity object.

Create an identity › Request Body

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Create an identity › Responses

Identity was created

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Get an identity

GET

https://api.cineamo.com

/identities/{identityId}

Returns an Identity object by its Id.

Get an identity › path Parameters

identityId

string · required

Get an identity › Responses

Identity details

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Update an identity

PATCH

https://api.cineamo.com

/identities/{identityId}

Updates an Identity. It returns the updated Identity object.

Update an identity › path Parameters

identityId

string · required

Update an identity › Request Body

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly

Update an identity › Responses

200

Identity was updated

Identity

id

string · readOnly

tenantId

string · readOnly

sourceType

string · readOnly

anonymousId

string · readOnly

consentStatus

string · readOnly

userId

string | null · readOnly

mergedIntoId

string | null · readOnly

firstSeenAt

string · readOnly

lastSeenAt

string · readOnly