Create Company

Headers

Authorization

string

required

Bearer token for authentication

Body

application/json

data

object

required

Show child attributes

data.type

string

required

Allowed value: "company"

data.attributes

object

required

Show child attributes

data.attributes.registration

object

required

Option 1
Option 2

Show child attributes

data.attributes.registration.registered_name

string

required

Legal company name

Example:

"TechCorp AI Solutions LLC"

data.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

Example:

"TechSol"

data.attributes.locale

string

Language settings.That’s the locale for the business relationship. Emails or documents can be used to identify the locale. Default EN.

Example:

"en-US"

data.attributes.domain_name_primary_link_url

string<uri>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Example:

"https://www.techcorp.com"

data.attributes.tax_id

object

Show child attributes

data.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

Example:

"DE123456789"

data.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.all tax id types See all available labels for complete list.

Example:

["VAT", "TVA", "IVA", "..."]

data.attributes.registration_number

object

Show child attributes

data.attributes.registration_number.business_type

enum<string>

Legal entity structure type. See all business entity types for complete list.

Available options:

Inc,

Corp,

LLC,

GmbH,

Ltd,

SA,

SAS

Example:

"GmbH"

data.attributes.registration_number.value

string

Official company registration number.

Example:

"HRB 123456"

data.attributes.registration_number.registry_name

string

Name of the official registration body. See all available registry name for complete list.

Example:

"Handelsregister Berlin"

data.attributes.registration_number.registry_country

string

Country of the registry authority. Must be valid ISO country code

Example:

"DE, FR, US, etc."

data.attributes.description

string

Company description explaining business purpose in max 2 sentences.

Required string length: 1 - 500

Example:

"An innovative technology company focused on AI solutions"

data.relationships

object

Relationships define how the company connects to other resources. To link an existing object, just put its ID. To create a new object, add it to the 'included' section with a temporary ID that matches the relationship reference.

Show child attributes

data.relationships.media

object

Media files associated with this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.media.data

object[]

Show child attributes

data.relationships.media.data.type

string

required

Allowed value: "media"

data.relationships.media.data.id

string

required

UUID of an existing medias or temp-id that references a medias defined in the included array

Example:

"media1"

data.relationships.web_links

object

Web links associated with this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.web_links.data

object[]

Show child attributes

data.relationships.web_links.data.type

string

required

Allowed value: "web_link"

data.relationships.web_links.data.id

string

required

UUID of an existing web-links or temp-id that references a web-links defined in the included array

Example:

"sl1"

data.relationships.emails

object

Email addresses associated with this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.emails.data

object[]

Show child attributes

data.relationships.emails.data.type

string

required

Allowed value: "email"

data.relationships.emails.data.id

string

required

UUID of an existing emails or temp-id that references a emails defined in the included array

Example:

"email1"

data.relationships.phones

object

Phone numbers associated with this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.phones.data

object[]

Show child attributes

data.relationships.phones.data.type

string

required

Allowed value: "phone"

data.relationships.phones.data.id

string

required

UUID of an existing phones or temp-id that references a phones defined in the included array

Example:

"phone1"

data.relationships.locations

object

Locations/addresses associated with this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.locations.data

object[]

Show child attributes

data.relationships.locations.data.type

string

required

Allowed value: "location"

data.relationships.locations.data.id

string

required

UUID of an existing locations or temp-id that references a locations defined in the included array

Example:

"loc1"

data.relationships.people

object

People associated with this company. Reference by type and id. The meta.relationship_type field specifies the person's role. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.people.data

object[]

Show child attributes

data.relationships.people.data.type

string

required

Allowed value: "people"

data.relationships.people.data.id

string

required

UUID of an existing people or temp-id that references a people defined in the included array

Example:

"people1"

data.relationships.people.data.meta

object

Show child attributes

data.relationships.people.data.meta.relationship_type

enum<string>

Relationship type of the person in the company. See all company roles for complete list.

Available options:

contact,

employee,

owner,

...

Example:

"owner"

data.relationships.parents

object

Parent company of this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.parents.data

object

Show child attributes

data.relationships.parents.data.type

string

required

Allowed value: "company"

data.relationships.parents.data.id

string

required

UUID of an existing parents or temp-id that references a parents defined in the included array

Example:

"parent_company1"

data.relationships.subsidiaries

object

Subsidiary companies of this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.subsidiaries.data

object[]

Show child attributes

data.relationships.subsidiaries.data.type

string

required

Allowed value: "company"

data.relationships.subsidiaries.data.id

string

required

UUID of an existing subsidiaries or temp-id that references a subsidiaries defined in the included array

Example:

"subsidiary1"

data.relationships.workspaces

object

Workspaces associated with this company. Reference by type and id. Use the 'include' query parameter to get full attributes in the included array.

Show child attributes

data.relationships.workspaces.data

object[]

Show child attributes

data.relationships.workspaces.data.type

string

required

Allowed value: "workspace"

data.relationships.workspaces.data.id

string

required

UUID of an existing workapces or temp-id that references a workspaces defined in the included array

Example:

"workspace_tenant"

data.included

object

Object containing included resources referenced in relationships, organized by resource type.

Show child attributes

data.included.people

object

People associated with this company

Show child attributes

data.included.people.data

object[]

Show child attributes

data.included.people.data.type

string

required

Allowed value: "people"

data.included.people.data.id

string<uuid>

required

temp-id that references a person defined in the relationship array

data.included.people.data.attributes

object

required

Show child attributes

data.included.people.data.attributes.first_name

string

required

First name of the person

Required string length: 1 - 50

Example:

"John"

data.included.people.data.attributes.last_name

string

required

Last name of the person (required)

Required string length: 1 - 50

Example:

"Doe"

data.included.parents

object

Parent company of this company

Show child attributes

data.included.parents.data

object

Show child attributes

data.included.parents.data.type

string

required

Allowed value: "company"

data.included.parents.data.id

string<uuid>

required

temp-id that references a parents defined in the relationship array

data.included.parents.data.attributes

object

required

Show child attributes

data.included.parents.data.attributes.registration

object

required

Option 1
Option 2

Show child attributes

data.included.parents.data.attributes.registration.registered_name

string

required

Legal company name

Example:

"TechCorp AI Solutions LLC"

data.included.parents.data.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

Example:

"TechSol"

data.included.parents.data.attributes.locale

string

Language settings.That’s the locale for the business relationship. Emails or documents can be used to identify the locale. Default EN.

Example:

"en-US"

data.included.parents.data.attributes.domain_name_primary_link_url

string<uri>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Example:

"https://www.techcorp.com"

data.included.parents.data.attributes.tax_id

object

Show child attributes

data.included.parents.data.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

Example:

"DE123456789"

data.included.parents.data.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.all tax id types See all available labels for complete list.

Example:

["VAT", "TVA", "IVA", "..."]

data.included.parents.data.attributes.registration_number

object

Show child attributes

data.included.parents.data.attributes.registration_number.business_type

enum<string>

Legal entity structure type. See all business entity types for complete list.

Available options:

Inc,

Corp,

LLC,

GmbH,

Ltd,

SA,

SAS

Example:

"GmbH"

data.included.parents.data.attributes.registration_number.value

string

Official company registration number.

Example:

"HRB 123456"

data.included.parents.data.attributes.registration_number.registry_name

string

Name of the official registration body. See all available registry name for complete list.

Example:

"Handelsregister Berlin"

data.included.parents.data.attributes.registration_number.registry_country

string

Country of the registry authority. Must be valid ISO country code

Example:

"DE, FR, US, etc."

data.included.parents.data.attributes.description

string

Company description explaining business purpose in max 2 sentences.

Required string length: 1 - 500

Example:

"An innovative technology company focused on AI solutions"

data.included.subsidiaries

object

Subsidiary companies of this company

Show child attributes

data.included.subsidiaries.data

object[]

Show child attributes

data.included.subsidiaries.data.type

string

required

Allowed value: "company"

data.included.subsidiaries.data.id

string<uuid>

required

temp-id that references a subsdiaries defined in the relationship array

data.included.subsidiaries.data.attributes

object

required

Show child attributes

data.included.subsidiaries.data.attributes.registration

object

required

Option 1
Option 2

Show child attributes

data.included.subsidiaries.data.attributes.registration.registered_name

string

required

Legal company name

Example:

"TechCorp AI Solutions LLC"

data.included.subsidiaries.data.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

Example:

"TechSol"

data.included.subsidiaries.data.attributes.locale

string

Language settings.That’s the locale for the business relationship. Emails or documents can be used to identify the locale. Default EN.

Example:

"en-US"

data.included.subsidiaries.data.attributes.domain_name_primary_link_url

string<uri>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Example:

"https://www.techcorp.com"

data.included.subsidiaries.data.attributes.tax_id

object

Show child attributes

data.included.subsidiaries.data.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

Example:

"DE123456789"

data.included.subsidiaries.data.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.all tax id types See all available labels for complete list.

Example:

["VAT", "TVA", "IVA", "..."]

data.included.subsidiaries.data.attributes.registration_number

object

Show child attributes

data.included.subsidiaries.data.attributes.registration_number.business_type

enum<string>

Legal entity structure type. See all business entity types for complete list.

Available options:

Inc,

Corp,

LLC,

GmbH,

Ltd,

SA,

SAS

Example:

"GmbH"

data.included.subsidiaries.data.attributes.registration_number.value

string

Official company registration number.

Example:

"HRB 123456"

data.included.subsidiaries.data.attributes.registration_number.registry_name

string

Name of the official registration body. See all available registry name for complete list.

Example:

"Handelsregister Berlin"

data.included.subsidiaries.data.attributes.registration_number.registry_country

string

Country of the registry authority. Must be valid ISO country code

Example:

"DE, FR, US, etc."

data.included.subsidiaries.data.attributes.description

string

Company description explaining business purpose in max 2 sentences.

Required string length: 1 - 500

Example:

"An innovative technology company focused on AI solutions"

data.included.workspaces

object

Workspaces associated with this company

Show child attributes

data.included.workspaces.data

object[]

Show child attributes

data.included.workspaces.data.type

string

required

Allowed value: "workspace"

data.included.workspaces.data.id

string<uuid>

required

temp-id that references a workspace defined in the relationship array

data.included.workspaces.data.attributes

object

required

Show child attributes

data.included.workspaces.data.attributes.name

string

required

Workspace name

Required string length: 1 - 255

data.included.workspaces.data.attributes.description

string

Workspace description

Maximum string length: 1000

data.included.workspaces.data.attributes.avatar_color

string

Avatar color in hexadecimal format (e.g., #FF5733)

data.included.workspaces.data.attributes.external_workspace_id

string

External workspace identifier

Required string length: 1 - 255

data.included.emails

object

Email addresses associated with this company

Show child attributes

data.included.emails.data

object[]

Show child attributes

data.included.emails.data.type

string

required

Allowed value: "email"

data.included.emails.data.id

string<uuid>

required

temp-id that references a emails defined in the relationship array

data.included.emails.data.attributes

object

required

Show child attributes

data.included.emails.data.attributes.value

string<email>

Email address value

Example:

"[email protected]"

data.included.emails.data.attributes.is_primary

boolean

default:true

Whether this is the primary email address. Defaults to 'false', unless no other email is marked as primary (in which case it becomes 'true'). Only one email can be marked as primary per person/company.

Example:

true

data.included.emails.data.attributes.label

enum<string>

default:work

Email label type. See all available labels for complete list.

Available options:

work,

personal,

other,

...

Example:

"work"

data.included.phones

object

Phone numbers associated with this company

Show child attributes

data.included.phones.data

object[]

Show child attributes

data.included.phones.data.type

string

required

Allowed value: "phone"

data.included.phones.data.id

string<uuid>

required

temp-id that references a phones defined in the relationship array

data.included.phones.data.attributes

object

required

Show child attributes

data.included.phones.data.attributes.number

string

required

Phone number in E164 format

Example:

"+14155552671"

data.included.phones.data.attributes.is_primary

boolean

default:true

Whether this is the primary phone number

data.included.phones.data.attributes.label

enum<string>

default:work

Phone label type. See all available labels for complete list.

Available options:

work,

personal,

other,

...

data.included.locations

object

Locations/addresses associated with this company

Show child attributes

data.included.locations.data

object[]

Show child attributes

data.included.locations.data.type

string

required

Allowed value: "location"

data.included.locations.data.id

string<uuid>

required

temp-id that references a location defined in the relationship array

data.included.locations.data.attributes

object

required

Show child attributes

data.included.locations.data.attributes.address_line1

string

required

Primary address line

data.included.locations.data.attributes.country

string

required

Two-letter ISO country code (e.g., 'US', 'GB')

data.included.locations.data.attributes.address_line2

string

Secondary address line (optional)

data.included.locations.data.attributes.city

string

City name

data.included.locations.data.attributes.region

string

State, province, or region

data.included.locations.data.attributes.postal_code

string

Postal or ZIP code

data.included.locations.data.attributes.latitude

number<float>

Geographic latitude coordinate

data.included.locations.data.attributes.longitude

number<float>

Geographic longitude coordinate

data.included.locations.data.attributes.is_primary

boolean

default:false

Whether this is the primary location

data.included.locations.data.attributes.is_registered

boolean

default:false

Whether this is a registered business address

data.included.locations.data.attributes.label

enum<string>

Email label type. See all available labels for complete list.

Available options:

work,

personal,

other,

...

data.included.media

object

Media files associated with this company

Show child attributes

data.included.media.data

object[]

Show child attributes

data.included.media.data.type

string

required

Allowed value: "media"

data.included.media.data.id

string<uuid>

required

temp-id that references a media defined in the relationship array

data.included.media.data.attributes

object

required

Show child attributes

data.included.media.data.attributes.file

file

required

Image in png, jpg or svg format

data.included.media.data.attributes.type

string

required

Resource type identifier

Allowed value: "media"

data.included.media.data.attributes.media_type

enum<string>

Type of media (avatar, logo, banner)

Available options:

avatar,

logo,

banner

data.included.media.data.attributes.is_primary

boolean

default:true

Marks preferred media. Default: true

data.included.web_links

object

Web links associated with this company

Show child attributes

data.included.web_links.data

object[]

Show child attributes

data.included.web_links.data.type

string

required

Allowed value: "web_link"

data.included.web_links.data.id

string<uuid>

required

UUID of an existing web-links or temp-id that references a web-links defined in the included array

data.included.web_links.data.attributes

object

required

Show child attributes

data.included.web_links.data.attributes.url

string

required

Full profile URL

Required string length: 1 - 500

data.included.web_links.data.attributes.platform

enum<string>

Web platform type

Available options:

website,

linkedin,

x,

github

data.included.documents

object

Documents associated with this company

Show child attributes

data.included.documents.data

object[]

Show child attributes

data.included.documents.data.type

string

Allowed value: "document"

data.included.documents.data.id

string<uuid>

UUID of an existing documents or temp-id that references a documents defined in the included array

data.included.documents.data.attributes

object

Show child attributes

data.included.documents.data.attributes.file_name

string

data.included.documents.data.attributes.status

string

data.included.documents.data.attributes.file_type

string

data.included.documents.data.attributes.size_bytes

integer

data.included.documents.data.required

any

Response

Company created successfully

data

object

Show child attributes

data.type

string

Allowed value: "company"

data.id

string<uuid>

UUID of the created company

Example:

"550e8400-e29b-41d4-a716-446655440000"

data.attributes

object

Show child attributes

data.attributes.description

string

data.attributes.domain_name_primary_link_url

string<url>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Maximum string length: 500

data.attributes.tax_id

object

Show child attributes

data.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

data.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.

data.attributes.registration

object

Show child attributes

data.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

data.attributes.registration.registered_name

string

Legal company name.

Required string length: 1 - 100

data.attributes.registration_number

object

Show child attributes

data.attributes.registration_number.business_type

string

Legal entity structure type.

data.attributes.registration_number.value

string

Official company registration number.

data.attributes.registration_number.registry_name

string

Name of the official registration body.

data.attributes.registration_number.registry_country

string

Country of the registry authority. (string (ISO 3166-1 alpha-2))

data.attributes.workspace_id

string<uuid>

UUID of the workspace associated with this company

data.attributes.created_at

string<date-time>

data.attributes.updated_at

string<date-time>

data.relationships

object

Show child attributes

data.relationships.created_by

object

Show child attributes

data.relationships.created_by.data

object

Show child attributes

data.relationships.created_by.data.type

string

Allowed value: "people"

data.relationships.created_by.data.id

string<uuid>

UUID of the person who created this company

Example:

"550e8400-e29b-41d4-a716-446655440001"

data.relationships.medias

object

Show child attributes

data.relationships.medias.data

object[]

Show child attributes

data.relationships.medias.data.type

string

Allowed value: "media"

data.relationships.medias.data.id

string<uuid>

UUID of the media file

Example:

"550e8400-e29b-41d4-a716-446655440002"

data.relationships.web_links

object

Show child attributes

data.relationships.web_links.data

object[]

Show child attributes

data.relationships.web_links.data.type

string

Allowed value: "web_link"

data.relationships.web_links.data.id

string<uuid>

UUID of the web link

Example:

"550e8400-e29b-41d4-a716-446655440003"

data.relationships.emails

object

Show child attributes

data.relationships.emails.data

object[]

Show child attributes

data.relationships.emails.data.type

string

Allowed value: "email"

data.relationships.emails.data.id

string<uuid>

UUID of the email

Example:

"550e8400-e29b-41d4-a716-446655440004"

data.relationships.phones

object

Show child attributes

data.relationships.phones.data

object[]

Show child attributes

data.relationships.phones.data.type

string

Allowed value: "phone"

data.relationships.phones.data.id

string<uuid>

UUID of the phone

Example:

"550e8400-e29b-41d4-a716-446655440005"

data.relationships.locations

object

Show child attributes

data.relationships.locations.data

object[]

Show child attributes

data.relationships.locations.data.type

string

Allowed value: "location"

data.relationships.locations.data.id

string<uuid>

UUID of the location

Example:

"550e8400-e29b-41d4-a716-446655440007"

data.relationships.people

object

Show child attributes

data.relationships.people.data

object[]

Show child attributes

data.relationships.people.data.type

string

Allowed value: "people"

data.relationships.people.data.id

string<uuid>

UUID of the person

Example:

"550e8400-e29b-41d4-a716-446655440008"

data.relationships.people.data.meta

object

Show child attributes

data.relationships.people.data.meta.relationship_type

enum<string>

Relationship type of the person in the company

Available options:

contact,

employee,

owner,

other

Example:

"employee"

data.relationships.documents

object

Show child attributes

data.relationships.documents.data

object[]

Show child attributes

data.relationships.documents.data.type

string

Allowed value: "document"

data.relationships.documents.data.id

string<uuid>

UUID of the document

Example:

"550e8400-e29b-41d4-a716-446655440009"

data.relationships.parents

object

Show child attributes

data.relationships.parents.data

object[]

Show child attributes

data.relationships.parents.data.type

string

Allowed value: "company"

data.relationships.parents.data.id

string<uuid>

UUID of the parent company

Example:

"550e8400-e29b-41d4-a716-446655440012"

data.relationships.subsidiaries

object

Show child attributes

data.relationships.subsidiaries.data

object[]

Show child attributes

data.relationships.subsidiaries.data.type

string

Allowed value: "company"

data.relationships.subsidiaries.data.id

string<uuid>

UUID of the subsidiary company

Example:

"550e8400-e29b-41d4-a716-446655440013"

data.relationships.workspaces

object

Show child attributes

data.relationships.workspaces.data

object[]

Show child attributes

data.relationships.workspaces.data.type

string

Allowed value: "workspace"

data.relationships.workspaces.data.id

string<uuid>

UUID of the workspace

Example:

"632860b5-48b7-49eb-9dd1-8bddc634f387"

data.included

object

Object containing included resources referenced in relationships, organized by resource type. These are the actual created/linked resources with real UUIDs.

Show child attributes

data.included.created_by

object

Person who created this company

Show child attributes

data.included.created_by.data

object

Show child attributes

data.included.created_by.data.type

string

Allowed value: "people"

data.included.created_by.data.id

string<uuid>

UUID of the person

data.included.created_by.data.attributes

object

Show child attributes

data.included.created_by.data.attributes.first_name

string

The person's first name

data.included.created_by.data.attributes.last_name

string

The person's last name

data.included.created_by.data.attributes.full_name

string

The person's full name (typically first_name + last_name)

data.included.created_by.data.attributes.created_at

string<date-time>

Timestamp when the person was created

data.included.created_by.data.attributes.updated_at

string<date-time>

Timestamp when the person was last updated

data.included.people

object

Person associated with the company

Show child attributes

data.included.people.data

object

Show child attributes

data.included.people.data.type

string

Allowed value: "people"

data.included.people.data.id

string<uuid>

UUID of the person

data.included.people.data.attributes

object

Show child attributes

data.included.people.data.attributes.first_name

string

The person's first name

data.included.people.data.attributes.last_name

string

The person's last name

data.included.people.data.attributes.full_name

string

The person's full name (typically first_name + last_name)

data.included.people.data.attributes.created_at

string<date-time>

Timestamp when the person was created

data.included.people.data.attributes.updated_at

string<date-time>

Timestamp when the person was last updated

data.included.parents

object

Parent company of this company

Show child attributes

data.included.parents.data

object

Show child attributes

data.included.parents.data.type

string

Allowed value: "company"

data.included.parents.data.id

string<uuid>

UUID of the parent company

data.included.parents.data.attributes

object

Show child attributes

data.included.parents.data.attributes.description

string

data.included.parents.data.attributes.domain_name_primary_link_url

string<url>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Maximum string length: 500

data.included.parents.data.attributes.tax_id

object

Show child attributes

data.included.parents.data.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

data.included.parents.data.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.

data.included.parents.data.attributes.registration

object

Show child attributes

data.included.parents.data.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

data.included.parents.data.attributes.registration.registered_name

string

Legal company name.

Required string length: 1 - 100

data.included.parents.data.attributes.registration_number

object

Show child attributes

data.included.parents.data.attributes.registration_number.business_type

string

Legal entity structure type.

data.included.parents.data.attributes.registration_number.value

string

Official company registration number.

data.included.parents.data.attributes.registration_number.registry_name

string

Name of the official registration body.

data.included.parents.data.attributes.registration_number.registry_country

string

Country of the registry authority. (string (ISO 3166-1 alpha-2))

data.included.parents.data.attributes.workspace_id

string<uuid>

UUID of the workspace associated with this company

data.included.parents.data.attributes.created_at

string<date-time>

data.included.parents.data.attributes.updated_at

string<date-time>

data.included.subsidiaries

object

Subsidiary companies of this company

Show child attributes

data.included.subsidiaries.data

object[]

Show child attributes

data.included.subsidiaries.data.type

string

Allowed value: "company"

data.included.subsidiaries.data.id

string<uuid>

UUID of the subsidiary company

data.included.subsidiaries.data.attributes

object

Show child attributes

data.included.subsidiaries.data.attributes.description

string

data.included.subsidiaries.data.attributes.domain_name_primary_link_url

string<url>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Maximum string length: 500

data.included.subsidiaries.data.attributes.tax_id

object

Show child attributes

data.included.subsidiaries.data.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

data.included.subsidiaries.data.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.

data.included.subsidiaries.data.attributes.registration

object

Show child attributes

data.included.subsidiaries.data.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

data.included.subsidiaries.data.attributes.registration.registered_name

string

Legal company name.

Required string length: 1 - 100

data.included.subsidiaries.data.attributes.registration_number

object

Show child attributes

data.included.subsidiaries.data.attributes.registration_number.business_type

string

Legal entity structure type.

data.included.subsidiaries.data.attributes.registration_number.value

string

Official company registration number.

data.included.subsidiaries.data.attributes.registration_number.registry_name

string

Name of the official registration body.

data.included.subsidiaries.data.attributes.registration_number.registry_country

string

Country of the registry authority. (string (ISO 3166-1 alpha-2))

data.included.subsidiaries.data.attributes.workspace_id

string<uuid>

UUID of the workspace associated with this company

data.included.subsidiaries.data.attributes.created_at

string<date-time>

data.included.subsidiaries.data.attributes.updated_at

string<date-time>

data.included.workspaces

object

Workspaces associated with this company

Show child attributes

data.included.workspaces.data

object[]

Show child attributes

data.included.workspaces.data.type

string

Allowed value: "workspace"

data.included.workspaces.data.id

string<uuid>

UUID of the workspace

data.included.workspaces.data.attributes

object

Show child attributes

data.included.workspaces.data.attributes.name

string

Workspace name

data.included.workspaces.data.attributes.desription

string

Workspace description

data.included.workspaces.data.attributes.external_workspace_id

string<uuid>

external workspace id

data.included.workspaces.data.attributes.avatar_color

string<colors>

Color of the avatar

data.included.workspaces.data.attributes.created_at

string<date-time>

Timestamp when the workspace was created

data.included.workspaces.data.attributes.updated_at

string<date-time>

Timestamp when the workspace was last updated

data.included.emails

object

Email addresses associated with this company

Show child attributes

data.included.emails.data

object[]

Show child attributes

data.included.emails.data.type

string

required

Allowed value: "email"

data.included.emails.data.id

string<uuid>

required

UUID of the email

data.included.emails.data.attributes

object

required

Show child attributes

data.included.emails.data.attributes.value

string<email>

Email address value

Example:

"[email protected]"

data.included.emails.data.attributes.is_primary

boolean

default:true

Example:

true

data.included.emails.data.attributes.label

enum<string>

default:work

Email label type. See all available labels for complete list.

Available options:

work,

personal,

other,

...

Example:

"work"

data.included.emails.data.attributes.created_at

string<date-time>

Timestamp when the email was created

Example:

"2023-06-15T10:30:00Z"

data.included.emails.data.attributes.updated_at

string<date-time>

Timestamp when the email was last updated

Example:

"2023-06-15T10:30:00Z"

data.included.phones

object

Phone numbers associated with this company

Show child attributes

data.included.phones.data

object[]

Show child attributes

data.included.phones.data.type

string

Allowed value: "phone"

data.included.phones.data.id

string<uuid>

UUID of the phone

data.included.phones.data.attributes

object

Show child attributes

data.included.phones.data.attributes.number

string

Full international phone number in E164 format

Example:

"+14155552671"

data.included.phones.data.attributes.label

enum<string>

Phone label type. See all available labels for complete list.

Available options:

work,

personal,

other,

...

data.included.phones.data.attributes.is_primary

boolean

Whether this is the primary phone number

data.included.phones.data.attributes.created_at

string<date-time>

Timestamp when the phone was created

data.included.locations

object

Locations/addresses associated with this company

Show child attributes

data.included.locations.data

object[]

Show child attributes

data.included.locations.data.type

string

Allowed value: "location"

data.included.locations.data.id

string<uuid>

UUID of the location

data.included.locations.data.attributes

object

Show child attributes

data.included.locations.data.attributes.full_address

string

Complete formatted address

data.included.locations.data.attributes.address_line1

string

Primary address line

data.included.locations.data.attributes.address_line2

string

Secondary address line

data.included.locations.data.attributes.city

string

City name

data.included.locations.data.attributes.region

string

State, province, or region

data.included.locations.data.attributes.postal_code

string

Postal or ZIP code

data.included.locations.data.attributes.country

string

Two-letter ISO country code

data.included.locations.data.attributes.latitude

number<float>

Geographic latitude coordinate

data.included.locations.data.attributes.longitude

number<float>

Geographic longitude coordinate

data.included.locations.data.attributes.is_primary

boolean

Whether this is the primary location

data.included.locations.data.attributes.is_registered

boolean

Whether this is a registered business address

data.included.locations.data.attributes.label

string

Custom label for the location

data.included.locations.data.attributes.created_at

string<date-time>

Date and time when the location was created

data.included.locations.data.attributes.updated_at

string<date-time>

Date and time when the location was last updated

data.included.media

object

Media files associated with this company

Show child attributes

data.included.media.data

object[]

Show child attributes

data.included.media.data.type

string

Allowed value: "media"

data.included.media.data.id

string<uuid>

UUID of the media

data.included.media.data.attributes

object

Show child attributes

data.included.media.data.attributes.media_type

enum<string>

Available options:

avatar,

logo,

banner

data.included.media.data.attributes.url

string<uri>

URL to the media file

data.included.media.data.attributes.is_primary

boolean

Whether this is the primary media

data.included.media.data.attributes.processed_at

string<date-time>

Timestamp when media processing completed

data.included.media.data.attributes.uploaded_at

string<date-time>

data.included.web_links

object

Web links associated with this company

Show child attributes

data.included.web_links.data

object[]

Show child attributes

data.included.web_links.data.type

string

Allowed value: "web_link"

data.included.web_links.data.id

string<uuid>

UUID of the web link

data.included.web_links.data.attributes

object

Show child attributes

data.included.web_links.data.attributes.platform

enum<string>

Web platform type

Available options:

website,

linkedin,

x,

github

data.included.web_links.data.attributes.url

string

Full profile URL

data.included.web_links.data.attributes.created_at

string<date-time>

Date and time when the web link was created

data.included.web_links.data.attributes.updated_at

string<date-time>

Date and time when the web link was updated

data.included.documents

object

Documents associated with this company

Show child attributes

data.included.documents.data

object[]

Show child attributes

data.included.documents.data.type

string

Allowed value: "document"

data.included.documents.data.id

string<uuid>

UUID of the document

data.included.documents.data.attributes

object

Show child attributes

data.included.documents.data.attributes.file_name

string

data.included.documents.data.attributes.status

string

data.included.documents.data.attributes.uploaded_at

string<date-time>

data.included.documents.data.attributes.processed_at

string<date-time>

data.included.documents.data.attributes.file_type

string

data.included.documents.data.attributes.size_bytes

integer

Main Resources

Atomic Resources

System

Headers

Body

Response