For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact Us
Knowledge BaseProduct UpdatesAPI Documentation
Knowledge BaseProduct UpdatesAPI Documentation
    • Getting Started
  • API Reference
      • GETCheck if a company exists
      • POSTAdd company information
      • PUTUpdate companies in batch
      • DELSubmit a deletion request for a company and any related data
Contact Us
LogoLogo
API ReferenceCompany

Add company information

POST
https://api.cable.tech/v2/company
POST
/v2/company
$curl -X POST https://api.cable.tech/v2/company \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '[
>  {
>    "company_id": "comp-987654321",
>    "timestamp": "2024-01-15T09:30:00Z",
>    "is_test_company": false
>  }
>]'
1{
2  "success": true,
3  "write_count": 1,
4  "message": "Company information added successfully.",
5  "organization_id": "org-123456789"
6}
Endpoint for adding new company information
Was this page helpful?
Previous

Update companies in batch

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a list of objects.
company_idstringRequired>=1 character

Unique external identifier of the company entity, ID stored in your database / back-office

timestampdatetimeRequired
When this company record was created or last modified in your system, in ISO 8601 format.
is_test_companybooleanRequiredDefaults to false
If the company is a test company, this should be set to true
account_statusenumOptional
The account status for the related person at that timestamp. Refer to the Developer Guide "Entity Account Statuses" to understand what account statuses mean at Cable, and how to use them
Allowed values:
legal_namestringOptional
Legal name of the business
trading_namestringOptional
Trading name of the business
emailstringOptional
Main contact email for the company
addresseslist of objectsOptional
phone_numberstringOptional
Main contact telephone number for the company
typestringOptional
Business entity type. eg. Sole Trader, Limited Company
registration_numberobjectOptional
incorporation_datedateOptional
Date when the company was incorporated
incorporation_countrystringOptional2-3 characters

2 or 3 Character ISO 3166 Country Code (https://w.wiki/4rY)

incorporation_statestringOptional>=2 characters

State where the company was incorporated (US only)

primary_operation_countrystringOptional2-3 characters

2 or 3 Character ISO 3166 Country Code (https://w.wiki/4rY)

industrystringOptional
Nature of business
industry_classificationobjectOptional
source_of_wealthstringOptional>=1 character
Source of wealth of the company
source_of_fundsstringOptional>=1 character
Source of initial deposit of the company
first_transaction_completed_atdatetimeOptional
Original timestamp of when the person completed their first transaction
product_typestringOptional>=1 character
registered_as_inactivebooleanOptional
If the company is registered as inactive, this should be set to true

Response

Company added successfully
successboolean
Indicates if the write operation was successful.
write_countinteger
The number of records written to the database.
messagestring
Provides additional information about the operation result.
organization_idstring
The organization ID for which the operation was performed.

Errors

400
Bad Request Error
401
Unauthorized Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error