API reference
Instance company
Read and update a merchant's company, its representatives and consent records, through the instance gateway.
Get company
Retrieves information about the current company
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
Show properties
Show properties
Show properties
Show properties
Show properties
PERSON ORGANIZATIONShow properties
Show properties
GET /api/portal/instance/company HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"result": {
"id": "string",
"name": "string",
"email": "string",
"primary_color": "#c3c3c3",
"country_id": "US",
"state_id": "DE",
"industry_id": 2,
"sector_id": 0,
"criterias": [0],
"vat_number": "string",
"registration_number": "string",
"logo_url": "string",
"logo_light_url": "string",
"default_language": {
"id": "string",
"code": "EN",
"name": "English"
},
"contact_information": {
"email": "string",
"phone_number": 40741222333,
"fax_number": 40741222333
},
"offices": [{
"is_main": false,
"id": 0,
"name": "string",
"address": {
"id": {},
"country": {},
"state": {},
"city": {},
"address": {},
"address_2": {},
"postal_code": {},
"phone_number": {}
}
}],
"representatives": [{
"id": "string",
"type": "PERSON",
"email": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"position": "string",
"description": "string",
"avatar_url": "string",
"category": "string",
"jurisdiction": [{}],
"address": {},
"created_at": "string"
}],
"bank_accounts": [{
"id": 0,
"name": "string",
"account_number": "string"
}]
}
}Update company
Change company information and settings
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
PUT /api/portal/instance/company HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* { "name": "string", "email": "string", "vat_number": "string", "registration_number": "string", "primary_color": "#c3c3c3", "country": "US", "state": "DE", "industry_id": 2, "sector_id": 0, "logo_url": "155e178a582341ffba1a57f66on1col4.3d07ab5....", "logo_light_url": "155e178a582341ffba1a57f66on1col4.3d07ab5...." }
{}Get representatives
Retrieve all company-level representatives
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
PERSON ORGANIZATIONShow properties
GET /api/portal/instance/company/representatives HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"result": [{
"id": "string",
"type": "PERSON",
"email": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"position": "string",
"description": "string",
"avatar_url": "string",
"category": "string",
"jurisdiction": ["string"],
"address": {
"id": "string",
"country": "RO",
"state": "string",
"city": "string",
"address": "string",
"address_2": "string",
"postal_code": "string",
"phone_number": 40755111222
},
"created_at": "string"
}]
}Create representative
Create a new company-level representative
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
PERSON ORGANIZATIONDPO REPRESENTATIVE DATA_REPRESENTATIVEShow properties
Show properties
PERSON ORGANIZATIONShow properties
POST /api/portal/instance/company/representatives HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* { "type": "PERSON", "category": "DPO", "company_name": "string", "first_name": "string", "last_name": "string", "position": "string", "description": "string", "email": "string", "jurisdiction": [ "UK" ], "phone_number": "string", "postal_code": "string", "address": { "id": "string", "country": "RO", "state": "string", "city": "string", "address": "string", "address_2": "string", "postal_code": "string", "phone_number": 40755111222 }, "avatar_url": "string" }
{
"result": {
"id": "string",
"type": "PERSON",
"email": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"position": "string",
"description": "string",
"avatar_url": "string",
"category": "string",
"jurisdiction": ["string"],
"address": {
"id": "string",
"country": "RO",
"state": "string",
"city": "string",
"address": "string",
"address_2": "string",
"postal_code": "string",
"phone_number": 40755111222
},
"created_at": "string"
}
}Get representative
Retrieve information about a specific company-level representative
Path parameters:
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | Yes |
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
PERSON ORGANIZATIONShow properties
GET /api/portal/instance/company/representatives/{id} HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"result": {
"id": "string",
"type": "PERSON",
"email": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"position": "string",
"description": "string",
"avatar_url": "string",
"category": "string",
"jurisdiction": ["string"],
"address": {
"id": "string",
"country": "RO",
"state": "string",
"city": "string",
"address": "string",
"address_2": "string",
"postal_code": "string",
"phone_number": 40755111222
},
"created_at": "string"
}
}Update representative
Update a previously created company-level representative
Path parameters:
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | Yes |
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
PERSON ORGANIZATIONDPO REPRESENTATIVE DATA_REPRESENTATIVEShow properties
Show properties
PERSON ORGANIZATIONShow properties
PUT /api/portal/instance/company/representatives/{id} HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* { "type": "PERSON", "category": "DPO", "company_name": "string", "first_name": "string", "last_name": "string", "position": "string", "description": "string", "email": "string", "jurisdiction": [ "UK" ], "phone_number": "string", "postal_code": "string", "address": { "id": "string", "country": "RO", "state": "string", "city": "string", "address": "string", "address_2": "string", "postal_code": "string", "phone_number": 40755111222 }, "avatar_url": "string" }
{
"result": {
"id": "string",
"type": "PERSON",
"email": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"position": "string",
"description": "string",
"avatar_url": "string",
"category": "string",
"jurisdiction": ["string"],
"address": {
"id": "string",
"country": "RO",
"state": "string",
"city": "string",
"address": "string",
"address_2": "string",
"postal_code": "string",
"phone_number": 40755111222
},
"created_at": "string"
}
}Delete representative
Deletes a previously created company-level representative
Path parameters:
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | Yes |
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
DELETE /api/portal/instance/company/representatives/{id} HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"result": {
"deleted": false
}
}Prepare upload
This API endpoint is used when you want to upload a profile image to the representative. This will generate a signed upload URL you can use.
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
POST /api/portal/instance/company/representatives/sign-asset HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* { "mime": "image/png" }
{
"result": {
"url": "https://eu1.clym.io/api/u/CPK6....."
}
}Get countries
Retrieves a list of available countries and their states
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
Show properties
Show properties
GET /api/portal/instance/company/countries HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"meta": {
"current_page": 0,
"next_page": 0,
"prev_page": 0
},
"result": [{
"id": "US",
"name": "United States",
"continent_id": "NA",
"states": [{
"id": "AL",
"name": "Alabama"
}]
}]
}Get records
Retrieve a list of consent records generated by properties within this company
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | |
domain_id |
string | No | |
property_id |
string | No | |
receipt_type |
string | No | |
receipt_status |
string | No |
Show properties
Show properties
COOKIE_CONSENT AGE_CONFIRMATION WIRETAPPING VPPAALLOWED DENIED PARTIALShow properties
Show properties
Show properties
Show properties
Show properties
Show properties
GET /api/portal/instance/company/records HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"meta": {
"current_page": 0,
"next_page": 0,
"prev_page": 0
},
"result": [{
"receipt_id": "RCPT_hUQKjW16QoVkvKPjQFQ1goZs5NmN00Dx",
"receipt_type": "COOKIE_CONSENT",
"receipt_status": "ALLOWED",
"country": "string",
"region": "string",
"jurisdiction": "string",
"meta": {},
"data_collection": [{
"name": "string",
"description": "string",
"fields": [{}],
"partners": [{}],
"processors": [{}],
"purposes": [{}]
}],
"data_controller": {
"name": "string",
"logo": "string",
"phone_number": "string",
"url": "string",
"email": "string",
"address": {
"id": {},
"country": {},
"state": {},
"city": {},
"address": {},
"address_2": {},
"postal_code": {},
"phone_number": {}
}
},
"signature": "string",
"subject": "string",
"subject_auth": ["email"],
"subject_data": {},
"property_id": "string",
"created_at": "string"
}]
}Get record
Retrieve the information of a receipt record
Path parameters:
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | Yes |
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
COOKIE_CONSENT AGE_CONFIRMATION WIRETAPPING VPPAALLOWED DENIED PARTIALShow properties
Show properties
Show properties
Show properties
Show properties
Show properties
GET /api/portal/instance/company/records/{id} HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"result": {
"receipt_id": "RCPT_hUQKjW16QoVkvKPjQFQ1goZs5NmN00Dx",
"receipt_type": "COOKIE_CONSENT",
"receipt_status": "ALLOWED",
"country": "string",
"region": "string",
"jurisdiction": "string",
"meta": {},
"data_collection": [{
"name": "string",
"description": "string",
"fields": [{
"categories": {},
"consent_type": {},
"name": {}
}],
"partners": [{
"name": {},
"usage": {},
"url": {}
}],
"processors": [{}],
"purposes": [{
"category": {},
"is_primary": {},
"is_profiling": {},
"legal_base": {},
"legal_description": {},
"name": {},
"status": {},
"termination": {}
}]
}],
"data_controller": {
"name": "string",
"logo": "string",
"phone_number": "string",
"url": "string",
"email": "string",
"address": {
"id": "string",
"country": "RO",
"state": "string",
"city": "string",
"address": "string",
"address_2": "string",
"postal_code": "string",
"phone_number": 40755111222
}
},
"signature": "string",
"subject": "string",
"subject_auth": ["email"],
"subject_data": {},
"property_id": "string",
"created_at": "string"
}
}Get sectors
Retrieves a list of available system sectors
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
Show properties
GET /api/portal/instance/company/sectors HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"meta": {
"current_page": 0,
"next_page": 0,
"prev_page": 0
},
"result": [{
"id": 0,
"name": "string",
"description": "string"
}]
}Get industries
Retrieves a list of available system industries
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
Show properties
GET /api/portal/instance/company/industries HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"meta": {
"current_page": 0,
"next_page": 0,
"prev_page": 0
},
"result": [{
"id": 0,
"name": "string",
"description": "string"
}]
}Get criteria groups
Retrieves a list of available system criteria groups
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
merchant_id |
string | No | Merchant ID (takes priority over domain_id and property_id) |
domain_id |
string | No | Domain ID (takes priority over property_id) |
property_id |
string | No | Property ID |
Show properties
Show properties
USER COMPANYShow properties
GET /api/portal/instance/company/criteria-groups HTTP/1.1 Host: partners.clym.io Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{
"meta": {
"current_page": 0,
"next_page": 0,
"prev_page": 0
},
"result": [{
"id": 0,
"name": "string",
"description": "string",
"applied_to": "USER",
"criterias": [{
"id": 0,
"name": "string",
"value": "string"
}]
}]
}