Cint Accounts API
Endpoints for managing Accounts-related resources, such as users.
Endpoints for managing Accounts-related resources, such as users.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cint:cint-accounts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Demand Accounts API
description: Cint's demand ordering API is REST oriented.
version: '2025-12-18'
servers:
- description: Production server
url: https://api.cint.com/v1
security:
- BearerAuth: []
tags:
- name: Accounts
description: Endpoints for managing Accounts-related resources, such as users.
paths:
/accounts:
parameters:
- $ref: '#/components/parameters/CintAPIVersion-2025-12-18'
get:
tags:
- Accounts
summary: List all accounts
operationId: get_user_accounts
description: Retrieves a list of all accounts that the authenticated user is authorized to access. This list will be empty if you don't have access to any accounts.
responses:
'200':
description: Successfully returned list of accounts.
content:
application/json:
schema:
$ref: '#/components/schemas/AccountsList'
'400':
$ref: '#/components/responses/Error_BadRequest'
'401':
$ref: '#/components/responses/Error_Unauthorized'
'403':
$ref: '#/components/responses/Error_Forbidden'
'500':
$ref: '#/components/responses/Error_Internal'
/accounts/{account_id}/users:
parameters:
- $ref: '#/components/parameters/AccountID'
- $ref: '#/components/parameters/UserType'
- $ref: '#/components/parameters/CintAPIVersion-2025-12-18'
get:
tags:
- Accounts
summary: List all users for an account
operationId: get_account_users
description: Retrieves a list of all users who have access to a specific account. You can use the `user_type` query parameter to filter this list.
responses:
'200':
description: A list of users for the specified account.
content:
application/json:
schema:
$ref: '#/components/schemas/UsersList'
'400':
$ref: '#/components/responses/Error_BadRequest'
'401':
$ref: '#/components/responses/Error_Unauthorized'
'403':
$ref: '#/components/responses/Error_Forbidden'
'404':
$ref: '#/components/responses/Error_NotFound'
'500':
$ref: '#/components/responses/Error_Internal'
/accounts/{account_id}/service-clients:
parameters:
- $ref: '#/components/parameters/AccountID'
- $ref: '#/components/parameters/UserType'
- $ref: '#/components/parameters/CintAPIVersion-2025-12-18'
get:
tags:
- Accounts
summary: List all service clients for an account
operationId: get_account_service_clients
description: Lists all available service clients for an account.
responses:
'200':
description: Retrieves a list of all service clients for an account.
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceClientsList'
'400':
$ref: '#/components/responses/Error_BadRequest'
'401':
$ref: '#/components/responses/Error_Unauthorized'
'403':
$ref: '#/components/responses/Error_Forbidden'
'404':
$ref: '#/components/responses/Error_NotFound'
'500':
$ref: '#/components/responses/Error_Internal'
/accounts/{account_id}/users/{user_id}/business-units:
parameters:
- $ref: '#/components/parameters/AccountID'
- $ref: '#/components/parameters/UserID'
- $ref: '#/components/parameters/CintAPIVersion-2025-12-18'
get:
tags:
- Accounts
summary: Get default business unit assigned to user
operationId: get_user_account_business_unit_id
description: 'Returns the business unit ID associated with the specified user''s account.
:::info
This API doesn''t return all the business units within an account. To get all the business units for an account use `/accounts/{account_id}/business-units`.
:::'
responses:
'200':
description: The business unit associated with the specified user and account.
content:
application/json:
schema:
$ref: '#/components/schemas/UserAccountBusinessUnit'
'400':
$ref: '#/components/responses/Error_BadRequest'
'401':
$ref: '#/components/responses/Error_Unauthorized'
'403':
$ref: '#/components/responses/Error_Forbidden'
'404':
$ref: '#/components/responses/Error_NotFound'
'500':
$ref: '#/components/responses/Error_Internal'
components:
responses:
Error_Internal:
description: A request failed due to an internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
id: d94b8bb2-a540-4a91-9c05-2aa3ae9a5e1e
object: unexpected_internal_error
detail: an internal error has led to the failure of this operation
Error_Unauthorized:
description: A request is unauthorized.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
id: 1dcf0f40-f0d1-4cf6-8c00-c3d019d32faf
object: authorization_error
detail: no valid authorization provided for this operation
Error_NotFound:
description: A requested resource isn't found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
id: 7a5972ba-0825-4360-b852-fa2430e47034
object: not_found_error
detail: resource not found
Error_Forbidden:
description: A requested is forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
id: fe68cdd2-ee87-4dbf-8950-63c5cbca94c7
object: authorization_error
detail: you don't have the right permissions to perform this operation
Error_BadRequest:
description: A request is not valid and can't be processed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
id: 9e278238-d011-4e05-8327-1ce1d5d26254
object: bad_request_error
detail: Expected field 'foo' is missing.
parameters:
UserID:
in: path
name: user_id
schema:
$ref: '#/components/schemas/UserID'
required: true
description: Uniquely identifies a user.
AccountID:
name: account_id
description: The account's unique identifier.
in: path
required: true
schema:
$ref: '#/components/schemas/AccountID'
CintAPIVersion-2025-12-18:
name: Cint-API-Version
in: header
required: true
schema:
type: string
example: 2025-12-18
description: 'This header is MANDATORY for all API requests. The API version format is `YYYY-MM-DD`.
'
UserType:
name: user_type
in: query
description: Filters users by user type. Currently, only 'project_manager' is supported.
schema:
type: string
enum:
- project_manager
schemas:
ServiceClientsList:
type: object
description: A list of all service clients for a specific account.
readOnly: true
properties:
users:
type: array
description: A list of service clients.
items:
type: object
properties:
id:
$ref: '#/components/schemas/UserID'
email:
type: string
description: The email address of the service client.
name:
type: string
description: The name of the service client.
example:
- id: 43292405-363e-4fa3-85a6-6e74a49fab2e
email: jane.doe@cint.com
name: Jane Doe
- id: 54736158-e90e-404c-bc32-4d938f8a9cfa
email: john.doe@cint.com
name: John Doe
InvalidParam:
type: object
description: Describes a single invalid parameter in a request.
properties:
name:
type: string
description: The name of the parameter that failed validation.
reason:
type: string
description: A short explanation of why the parameter was invalid.
required:
- name
- reason
UserAccountBusinessUnit:
type: object
description: A response containing the business unit of the user's account.
properties:
business_unit_id:
type: integer
description: Unique identifier of the business unit.
example: 1234
UserID:
type: string
format: uuid
description: A unique identifier for the user.
example: b551326b-ac9d-4d32-8823-4f025787dab9
Error:
type: object
description: The standard error object returned for all failed API requests.
required:
- object
- detail
properties:
id:
type: string
format: uuid
description: A unique identifier for this specific error instance.
object:
type: string
description: A short informative string identifying the type of the error
pattern: ^([a-z]*_)*([a-z]*)$
detail:
type: string
description: An error message provides a concise overview of the cause of the error.
invalid_params:
type:
- array
- 'null'
description: An optional field containing a list of invalid parameters may be presented in validation errors for additional information.
items:
$ref: '#/components/schemas/InvalidParam'
AccountID:
description: The account's unique identifier.
type: integer
format: int32
example: 101
AccountsList:
type: object
description: A list of accounts the authenticated user can access.
readOnly: true
properties:
accounts:
type: array
description: A list of user accounts.
items:
type: object
properties:
id:
type: integer
description: A unique identifier for an account.
name:
type: string
description: The name of the account.
example:
- id: 1
name: Acme Inc.
- id: 2
name: Globex Corp.
UsersList:
type: object
description: A list of all users for a specific account.
readOnly: true
properties:
users:
type: array
description: A list of users.
items:
type: object
properties:
id:
$ref: '#/components/schemas/UserID'
email:
type: string
description: The email address of the user.
name:
type: string
description: The name of the user.
example:
- id: 43292405-363e-4fa3-85a6-6e74a49fab2e
email: jane.doe@cint.com
name: Jane Doe
- id: 54736158-e90e-404c-bc32-4d938f8a9cfa
email: john.doe@cint.com
name: John Doe
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Bearer token used for authentication and authorization. See [Authentication Process](https://developer.cint.com/en/guides#authentication-process) documentation for more information.
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: API Key Authentication