> ## Documentation Index > Fetch the complete documentation index at: https://docs.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # List Accounts ## OpenAPI ````yaml get /unified/crm/accounts openapi: 3.1.0 info: title: CRM description: The documentation for the StackOne Unified API - CRM version: 1.0.0 contact: {} servers: - url: https://api.stackone.com security: [] tags: - name: Accounts description: Customer or business accounts. - name: Contacts description: People or organizations that can be contacted. - name: Custom Field Definitions description: Definitions for custom fields on CRM resources. - name: Lists description: Lists for organizing contacts or accounts. paths: /unified/crm/accounts: get: tags: - Accounts summary: List Accounts operationId: crm_list_accounts parameters: - name: x-account-id in: header description: The account identifier required: true schema: type: string - name: raw required: false in: query description: >- Indicates that the raw request result should be returned in addition to the mapped result (default value is false) schema: nullable: true type: boolean - name: proxy required: false in: query description: >- Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key style: deepObject explode: true schema: additionalProperties: true nullable: true type: object - name: fields required: false in: query description: >- The comma separated list of fields that will be returned in the response (if empty, all fields are returned) schema: nullable: true example: >- id,remote_id,owner_id,remote_owner_id,name,description,industries,annual_revenue,website,addresses,phone_numbers,created_at,updated_at,unified_custom_fields type: string - name: filter required: false in: query description: >- Filter parameters that allow greater customisation of the list response explode: true style: deepObject schema: properties: updated_after: description: >- Use a string with a date to only select results updated after that given date example: '2020-01-01T00:00:00.000Z' type: string format: date-time nullable: true additionalProperties: false nullable: true type: object - name: page required: false in: query description: The page number of the results to fetch deprecated: true schema: type: string nullable: true - name: page_size required: false in: query description: The number of results per page (default value is 25) schema: type: string nullable: true - name: next required: false in: query description: The unified cursor schema: type: string nullable: true - name: updated_after required: false in: query description: >- Use a string with a date to only select results updated after that given date deprecated: true schema: format: date-time nullable: true example: '2020-01-01T00:00:00.000Z' type: string - name: Prefer in: header required: false description: >- Set to "heartbeat" to enable keep-alive newline heartbeats during long-running requests. Response includes Preference-Applied: heartbeat header when honored. (RFC 7240) schema: type: string example: heartbeat responses: '200': description: The list of accounts was retrieved. content: application/json: schema: $ref: '#/components/schemas/AccountsPaginated' '400': description: Invalid request. content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '401': description: Unauthorized access. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponse' '403': description: Forbidden. content: application/json: schema: $ref: '#/components/schemas/ForbiddenResponse' '404': description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/NotFoundResponse' '408': description: The request has timed out. headers: Retry-After: description: A time in seconds after which the request can be retried. schema: type: string content: application/json: schema: $ref: '#/components/schemas/RequestTimedOutResponse' '409': description: Conflict with current state. content: application/json: schema: $ref: '#/components/schemas/ConflictResponse' '412': description: >- Precondition failed: linked account belongs to a disabled integration. content: application/json: schema: $ref: '#/components/schemas/PreconditionFailedResponse' '422': description: Validation error. content: application/json: schema: $ref: '#/components/schemas/UnprocessableEntityResponse' '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsResponse' '500': description: Server error while executing the request. content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' '501': description: This functionality is not implemented. content: application/json: schema: $ref: '#/components/schemas/NotImplementedResponse' '502': description: Bad gateway error. content: application/json: schema: $ref: '#/components/schemas/BadGatewayResponse' security: - basic: [] components: schemas: AccountsPaginated: type: object properties: next_page: type: string deprecated: true nullable: true next: type: string nullable: true data: type: array items: $ref: '#/components/schemas/Account' raw: nullable: true type: array items: $ref: '#/components/schemas/RawResponse' required: - data BadRequestResponse: type: object properties: statusCode: type: number description: HTTP status code example: 400 message: type: string description: Error message example: Bad Request timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time data: description: Error details nullable: true allOf: - $ref: '#/components/schemas/UnifiedError' provider_errors: description: List of provider-specific errors nullable: true type: array items: $ref: '#/components/schemas/ProviderError' required: - statusCode - message - timestamp UnauthorizedResponse: type: object properties: statusCode: type: number description: HTTP status code example: 401 message: type: string description: Error message example: Unauthorized timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp ForbiddenResponse: type: object properties: statusCode: type: number description: HTTP status code example: 403 message: type: string description: Error message example: Forbidden resource timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp NotFoundResponse: type: object properties: statusCode: type: number description: HTTP status code example: 404 message: type: string description: Error message example: Not Found timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp RequestTimedOutResponse: type: object properties: statusCode: type: number description: HTTP status code example: 408 message: type: string description: Error message example: Request timed out timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp ConflictResponse: type: object properties: statusCode: type: number description: HTTP status code example: 409 message: type: string description: Error message example: Conflict timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp PreconditionFailedResponse: type: object properties: statusCode: type: number description: HTTP status code example: 412 message: type: string description: Error message example: Precondition failed timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp UnprocessableEntityResponse: type: object properties: statusCode: type: number description: HTTP status code example: 422 message: type: string description: Error message example: Unprocessable Entity timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp TooManyRequestsResponse: type: object properties: statusCode: type: number description: HTTP status code example: 429 message: type: string description: Error message example: Too many requests timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp InternalServerErrorResponse: type: object properties: statusCode: type: number description: HTTP status code example: 500 message: type: string description: Error message example: Internal server error timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp NotImplementedResponse: type: object properties: statusCode: type: number description: HTTP status code example: 501 message: type: string description: Error message example: Not Implemented timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp BadGatewayResponse: type: object properties: statusCode: type: number description: HTTP status code example: 502 message: type: string description: Error message example: Bad Gateway timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp Account: type: object properties: id: type: string description: Unique identifier example: 8187e5da-dc77-475e-9949-af0f1fa4e4e3 nullable: true remote_id: type: string description: Provider's unique identifier example: 8187e5da-dc77-475e-9949-af0f1fa4e4e3 nullable: true unified_custom_fields: type: object description: Custom Unified Fields configured in your StackOne project additionalProperties: true example: my_project_custom_field_1: REF-1236 my_project_custom_field_2: some other value nullable: true owner_id: type: string nullable: true remote_owner_id: type: string description: Provider's unique identifier of the owner example: e3cb75bf-aa84-466e-a6c1-b8322b257a48 nullable: true name: type: string nullable: true description: type: string nullable: true industries: description: Values of the industries example: - Information Technology - Airlines & Airports - Personal Care & Household Products nullable: true type: array items: type: string annual_revenue: type: string nullable: true website: type: string nullable: true addresses: nullable: true type: array items: $ref: '#/components/schemas/AccountAddress' phone_numbers: description: List of account phone numbers example: - '+1123425334' nullable: true type: array items: type: string created_at: type: string description: Timestamp when the account was created example: '2021-01-01T01:01:01.000Z' format: date-time nullable: true updated_at: type: string description: Timestamp when the account was last updated example: '2021-01-01T01:01:01.000Z' format: date-time nullable: true RawResponse: type: object properties: method: type: string url: type: string body: oneOf: - type: string - type: object - type: array items: type: integer format: int32 minimum: 0 maximum: 255 additionalProperties: true nullable: true response: oneOf: - type: object additionalProperties: true - type: array items: {} - type: string nullable: true required: - method - url UnifiedError: type: object properties: statusCode: type: number description: HTTP status code example: 400 nullable: true message: type: string description: Error message example: Bad Request nullable: true headers: type: object description: Response headers example: content-type: application/json x-request-id: 5678c28b211dace4e0a0f9171e6b88c5 nullable: true ProviderError: type: object properties: status: type: number description: HTTP status code of the provider error example: 400 nullable: true url: type: string description: URL that caused the error example: https://api.provider.com/v1/resource nullable: true raw: type: object description: Raw error response from the provider example: message: Invalid input parameters nullable: true headers: type: object description: Response headers example: content-type: application/json x-request-id: 5678c28b211dace4e0a0f9171e6b88c5 nullable: true AccountAddress: type: object properties: street_1: type: string nullable: true street_2: type: string nullable: true city: type: string nullable: true state: type: string nullable: true zip_code: type: string nullable: true country: description: The country code nullable: true allOf: - $ref: '#/components/schemas/CountryEnum' location_type: description: The location type nullable: true allOf: - $ref: '#/components/schemas/LocationTypeEnum' CountryEnum: type: object properties: value: type: string enum: - AF - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - KH - CM - CA - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - HR - CU - CW - CY - CZ - CI - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KP - KR - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MK - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RO - RU - RW - RE - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - SS - ES - LK - SD - SR - SJ - SZ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - US - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW - unmapped_value - null description: The ISO 3166-1 alpha-2 code of the country. example: GB x-speakeasy-unknown-values: allow nullable: true source_value: description: The source value of the ISO 3166-1 alpha-2 code of the country. example: GB oneOf: - type: string - type: number - type: boolean - type: object - type: array items: {} nullable: true LocationTypeEnum: type: object properties: value: type: string enum: - home - work - unmapped_value - null description: The type of the location. example: home x-speakeasy-unknown-values: allow nullable: true source_value: description: The source value of the location type. example: Home oneOf: - type: string - type: number - type: boolean - type: object - type: array items: {} nullable: true securitySchemes: basic: type: http scheme: basic ````