List parties

UAT Env

GET

/parties

Requires scope party:list.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/parties?token=&count=&principal_id=&role=&customer_party_ref=' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>'

Response Example

[
    {
        "id": "0199ba56-1452-770c-8e6b-3bebd1dd012b",
        "create_time": "2026-10-05T03:12:45.123Z",
        "update_time": "2026-10-05T03:12:45.123Z",
        "token": "AZm0pm8ufDGaO10ujxxKEA",
        "etag": "\"AZm0pm8ufDGaO10ujxxKEAAAAAAAAAAB\"",
        "customer_id": "0199b1e3-8d67-7dbe-88f4-7d244e0ba9ff",
        "principal_id": "0199b394-4198-78d8-8ada-3c9f86d227d6",
        "customer_party_ref": "customer-ref-0001",
        "role": "end-user"
    }
]

Retrieve a party

Retrieve a party attribute