Chameleoon Delivery

Activate and manage Chameleoon Delivery — shipping under Chameleoon's own carrier contracts (PPL and Balíkovna) instead of bringing your own courier credentials.

Activation is contract-based and mirrors the onboarding wizard in the partner portal:

Create the contract — POST /v2/chameleoon-delivery/contract creates a draft contract (pending, submittedAt unset).
Add at least one pickup address — POST /v2/chameleoon-delivery/contract/addresses.
Add at least one bank account — POST /v2/chameleoon-delivery/contract/bank-accounts (for cash-on-delivery payouts).
Submit for approval — POST /v2/chameleoon-delivery/contract/submit. Chameleoon reviews the contract and moves it to active.
Enable carriers — once the contract is active, enable ppl and/or balikovna via POST /v2/chameleoon-delivery/contract/carriers.

Read the current state, status, addresses, bank accounts, and enabled carriers any time via GET /v2/chameleoon-delivery/contract. Chameleoon Delivery currently operates in Czechia only.

Get Chameleoon Delivery contract

GET

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract

Returns the partner's Chameleoon Delivery contract, including its current status, addresses, bank accounts, and enabled carriers. Returns 404 if no contract has been created yet.

Get Chameleoon Delivery contract › Headers

Accept-Language

string · enum

Language code for localized responses

Enum values:

Default: en

Get Chameleoon Delivery contract › Responses

The Chameleoon Delivery contract

A partner's Chameleoon Delivery contract — the onboarding record that, once approved, lets the partner ship under Chameleoon's own PPL and Balíkovna carrier contracts.

ChameleoonDeliveryContractDto

id

string · uuid · required

Unique contract identifier

status

ContractStatus · enum · required

Lifecycle status of a Chameleoon Delivery contract, and of each carrier within it.

pending — created and still editable, or submitted and awaiting Chameleoon approval (tell the two apart via the contract's submittedAt)
active — approved by Chameleoon and usable
suspended — temporarily disabled by Chameleoon
deactivated — permanently disabled

Enum values:

pending

active

suspended

deactivated

submittedAt

string · date-time

When the contract was submitted for approval; null while still a draft (format yyyy-MM-ddTHH:mm:ss.fff)

ContractAddressDto[]

Pickup / cover / return addresses on the contract

ContractBankAccountDto[]

Bank accounts used for cash-on-delivery payouts

ContractCourierItemDto[]

Carriers enabled (or pending) within the contract

created

string · date-time

When the contract was created (format yyyy-MM-ddTHH:mm:ss.fff)

changed

string · date-time

When the contract was last changed (format yyyy-MM-ddTHH:mm:ss.fff)

GET/v2/chameleoon-delivery/contract

curl https://api.chameleoon.sk/v2/chameleoon-delivery/contract \
  --header 'X-Chameleoon-ApiKey: <api-key>'

Example Responses

{
  "id": "e5b357eb-837d-41c0-82c8-663b8399ff47",
  "status": "active",
  "submittedAt": "2026-01-15T09:30:00.000",
  "addresses": [
    {
      "id": "8d3b1c2a-1f4e-4c2b-9a3d-2f6e7c8b9a01",
      "title": "Main warehouse",
      "pickup": {
        "company": "Test s.r.o.",
        "contactPerson": "John Doe",
        "street": "Trojičné námestie 122",
        "city": "Praha",
        "zipCode": "10000",
        "countryCode": "CZ",
        "phone": "+420123456789",
        "email": "warehouse@example.com"
      }
    }
  ],
  "bankAccounts": [
    {
      "id": "3c9a7d61-5b2e-4f08-8c1a-9d4e6f2b7a30",
      "currency": "CZK",
      "holderName": "Test s.r.o.",
      "iban": "CZ6508000000192000145399",
      "swift": "GIBACZPX"
    }
  ],
  "courierItems": [
    {
      "courierId": "ppl",
      "status": "active",
      "statusChangedAt": "2026-01-16T08:00:00.000",
      "activatedAt": "2026-01-16T08:00:00.000"
    }
  ],
  "created": "2026-01-10T12:00:00.000",
  "changed": "2026-01-16T08:00:00.000"
}

json

application/json

Create Chameleoon Delivery contract

POST

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract

Creates a new draft Chameleoon Delivery contract for the partner. The contract starts in pending status with submittedAt unset. Add at least one address and one bank account, then submit it for approval. A partner can have only one contract — calling this when a contract already exists returns 409.

Create Chameleoon Delivery contract › Responses

Contract created

A partner's Chameleoon Delivery contract — the onboarding record that, once approved, lets the partner ship under Chameleoon's own PPL and Balíkovna carrier contracts.

ChameleoonDeliveryContractDto

id

string · uuid · required

Unique contract identifier

status

ContractStatus · enum · required

Lifecycle status of a Chameleoon Delivery contract, and of each carrier within it.

pending — created and still editable, or submitted and awaiting Chameleoon approval (tell the two apart via the contract's submittedAt)
active — approved by Chameleoon and usable
suspended — temporarily disabled by Chameleoon
deactivated — permanently disabled

Enum values:

pending

active

suspended

deactivated

submittedAt

string · date-time

When the contract was submitted for approval; null while still a draft (format yyyy-MM-ddTHH:mm:ss.fff)

ContractAddressDto[]

Pickup / cover / return addresses on the contract

ContractBankAccountDto[]

Bank accounts used for cash-on-delivery payouts

ContractCourierItemDto[]

Carriers enabled (or pending) within the contract

created

string · date-time

When the contract was created (format yyyy-MM-ddTHH:mm:ss.fff)

changed

string · date-time

When the contract was last changed (format yyyy-MM-ddTHH:mm:ss.fff)

Submit Chameleoon Delivery contract for approval

POST

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/submit

Submits the draft contract for Chameleoon's approval and stamps submittedAt. Requires at least one address and one bank account. Fails with 409 if the contract was already submitted, and with 422 if the contract is incomplete.

Submit Chameleoon Delivery contract for approval › Responses

Contract submitted for approval

No data returned

Add contract address

POST

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/addresses

Adds a pickup address (with optional cover and return addresses) to the contract.

Add contract address › Request Body

Request body for creating or updating a contract address.

SaveContractAddressRequestDto

title

string · required

Display label for this address entry

ContractAddressDetailDto · required

A single physical address used on a Chameleoon Delivery contract. The same shape is used for the pickup, cover (billing), and return addresses.

object

Optional billing / cover address. Defaults to the pickup address when omitted.

object

Optional return address for undelivered shipments. Defaults to the pickup address when omitted.

Add contract address › Responses

Address created

A named address entry on the contract. `pickup` is required; `cover` (billing) and `return` are optional and fall back to the pickup address when omitted.

ContractAddressDto

title

string · required

Display label for this address entry

ContractAddressDetailDto · required

A single physical address used on a Chameleoon Delivery contract. The same shape is used for the pickup, cover (billing), and return addresses.

id

string · uuid · readOnly

Unique address identifier

object

Optional billing / cover address. Defaults to the pickup address when omitted.

object

Optional return address for undelivered shipments. Defaults to the pickup address when omitted.

POST/v2/chameleoon-delivery/contract/addresses

curl https://api.chameleoon.sk/v2/chameleoon-delivery/contract/addresses \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-Chameleoon-ApiKey: <api-key>' \
  --data '{
  "title": "Main warehouse",
  "pickup": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  }
}'

Example Request Body

{
  "title": "Main warehouse",
  "pickup": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  }
}

json

application/json

Example Responses

{
  "id": "8d3b1c2a-1f4e-4c2b-9a3d-2f6e7c8b9a01",
  "title": "Main warehouse",
  "pickup": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  }
}

json

application/json

Update contract address

PUT

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/addresses/{addressId}

Updates an existing contract address.

Update contract address › path Parameters

addressId

string · uuid · required

Unique address identifier

Update contract address › Request Body

Request body for creating or updating a contract address.

SaveContractAddressRequestDto

title

string · required

Display label for this address entry

ContractAddressDetailDto · required

A single physical address used on a Chameleoon Delivery contract. The same shape is used for the pickup, cover (billing), and return addresses.

object

Optional billing / cover address. Defaults to the pickup address when omitted.

object

Optional return address for undelivered shipments. Defaults to the pickup address when omitted.

Update contract address › Responses

Address updated

A named address entry on the contract. `pickup` is required; `cover` (billing) and `return` are optional and fall back to the pickup address when omitted.

ContractAddressDto

title

string · required

Display label for this address entry

ContractAddressDetailDto · required

A single physical address used on a Chameleoon Delivery contract. The same shape is used for the pickup, cover (billing), and return addresses.

id

string · uuid · readOnly

Unique address identifier

object

Optional billing / cover address. Defaults to the pickup address when omitted.

object

Optional return address for undelivered shipments. Defaults to the pickup address when omitted.

PUT/v2/chameleoon-delivery/contract/addresses/{addressId}

curl https://api.chameleoon.sk/v2/chameleoon-delivery/contract/addresses/:addressId \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'X-Chameleoon-ApiKey: <api-key>' \
  --data '{
  "title": "Main warehouse",
  "pickup": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  },
  "cover": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  },
  "return": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  }
}'

Example Request Body

{
  "title": "Main warehouse",
  "pickup": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  },
  "cover": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  },
  "return": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  }
}

json

Example Responses

{
  "id": "8d3b1c2a-1f4e-4c2b-9a3d-2f6e7c8b9a01",
  "title": "Main warehouse",
  "pickup": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  },
  "cover": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  },
  "return": {
    "company": "Test s.r.o.",
    "contactPerson": "John Doe",
    "street": "Trojičné námestie 122",
    "city": "Praha",
    "zipCode": "10000",
    "countryCode": "CZ",
    "phone": "+420123456789",
    "email": "warehouse@example.com"
  }
}

json

application/json

Remove contract address

DELETE

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/addresses/{addressId}

Removes an address from the contract.

Remove contract address › path Parameters

addressId

string · uuid · required

Unique address identifier

Remove contract address › Responses

Address removed

No data returned

Add contract bank account

POST

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/bank-accounts

Adds a bank account to the contract, used for cash-on-delivery payouts. Provide either iban, or accountNumber together with bankCode.

Add contract bank account › Request Body

Request body for creating or updating a bank account. Provide either `iban`, or `accountNumber` together with `bankCode`.

SaveContractBankAccountRequestDto

currency

string · enum · required

Payout currency

Enum values:

CZK

EUR

holderName

string · required

Account holder name

iban

string

IBAN. Provide this, or accountNumber + bankCode.

swift

string

SWIFT / BIC code

accountNumber

string

Domestic account number. Use together with bankCode when iban is not provided.

bankCode

string

Domestic bank code. Use together with accountNumber when iban is not provided.

Add contract bank account › Responses

Bank account created

A bank account on the contract, used for cash-on-delivery payouts. Provide either `iban`, or `accountNumber` together with `bankCode`.

ContractBankAccountDto

currency

string · enum · required

Payout currency

Enum values:

CZK

EUR

holderName

string · required

Account holder name

id

string · uuid · readOnly

Unique bank account identifier

iban

string

IBAN. Provide this, or accountNumber + bankCode.

swift

string

SWIFT / BIC code

accountNumber

string

Domestic account number. Use together with bankCode when iban is not provided.

bankCode

string

Domestic bank code. Use together with accountNumber when iban is not provided.

POST/v2/chameleoon-delivery/contract/bank-accounts

curl https://api.chameleoon.sk/v2/chameleoon-delivery/contract/bank-accounts \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-Chameleoon-ApiKey: <api-key>' \
  --data '{
  "currency": "CZK",
  "holderName": "Test s.r.o.",
  "iban": "CZ6508000000192000145399",
  "swift": "GIBACZPX"
}'

Example Request Body

{
  "currency": "CZK",
  "holderName": "Test s.r.o.",
  "iban": "CZ6508000000192000145399",
  "swift": "GIBACZPX"
}

json

application/json

Example Responses

{
  "id": "3c9a7d61-5b2e-4f08-8c1a-9d4e6f2b7a30",
  "currency": "CZK",
  "holderName": "Test s.r.o.",
  "iban": "CZ6508000000192000145399",
  "swift": "GIBACZPX"
}

json

application/json

Update contract bank account

PUT

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/bank-accounts/{bankAccountId}

Updates an existing bank account. Provide either iban, or accountNumber together with bankCode.

Update contract bank account › path Parameters

bankAccountId

string · uuid · required

Unique bank account identifier

Update contract bank account › Request Body

Request body for creating or updating a bank account. Provide either `iban`, or `accountNumber` together with `bankCode`.

SaveContractBankAccountRequestDto

currency

string · enum · required

Payout currency

Enum values:

CZK

EUR

holderName

string · required

Account holder name

iban

string

IBAN. Provide this, or accountNumber + bankCode.

swift

string

SWIFT / BIC code

accountNumber

string

Domestic account number. Use together with bankCode when iban is not provided.

bankCode

string

Domestic bank code. Use together with accountNumber when iban is not provided.

Update contract bank account › Responses

Bank account updated

A bank account on the contract, used for cash-on-delivery payouts. Provide either `iban`, or `accountNumber` together with `bankCode`.

ContractBankAccountDto

currency

string · enum · required

Payout currency

Enum values:

CZK

EUR

holderName

string · required

Account holder name

id

string · uuid · readOnly

Unique bank account identifier

iban

string

IBAN. Provide this, or accountNumber + bankCode.

swift

string

SWIFT / BIC code

accountNumber

string

Domestic account number. Use together with bankCode when iban is not provided.

bankCode

string

Domestic bank code. Use together with accountNumber when iban is not provided.

PUT/v2/chameleoon-delivery/contract/bank-accounts/{bankAccountId}

curl https://api.chameleoon.sk/v2/chameleoon-delivery/contract/bank-accounts/:bankAccountId \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'X-Chameleoon-ApiKey: <api-key>' \
  --data '{
  "currency": "CZK",
  "holderName": "Test s.r.o.",
  "iban": "CZ6508000000192000145399",
  "swift": "GIBACZPX",
  "accountNumber": "192000145399",
  "bankCode": "0800"
}'

Example Request Body

{
  "currency": "CZK",
  "holderName": "Test s.r.o.",
  "iban": "CZ6508000000192000145399",
  "swift": "GIBACZPX",
  "accountNumber": "192000145399",
  "bankCode": "0800"
}

json

Example Responses

{
  "id": "3c9a7d61-5b2e-4f08-8c1a-9d4e6f2b7a30",
  "currency": "CZK",
  "holderName": "Test s.r.o.",
  "iban": "CZ6508000000192000145399",
  "swift": "GIBACZPX",
  "accountNumber": "192000145399",
  "bankCode": "0800"
}

json

application/json

Remove contract bank account

DELETE

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/bank-accounts/{bankAccountId}

Removes a bank account from the contract.

Remove contract bank account › path Parameters

bankAccountId

string · uuid · required

Unique bank account identifier

Remove contract bank account › Responses

Bank account removed

No data returned

Enable a carrier

POST

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/carriers

Requests activation of a carrier (ppl or balikovna) within the contract. The contract must be active (approved). The carrier item starts in pending until Chameleoon completes its setup, after which it becomes active.

Enable a carrier › Request Body

Request body for enabling a carrier within an active contract.

RequestContractCarrierRequestDto

courierId

string · enum · required

Carrier identifier to enable

Enum values:

ppl

balikovna

Enable a carrier › Responses

Carrier enablement requested

A carrier enabled (or pending) within a Chameleoon Delivery contract.

ContractCourierItemDto

courierId

string · enum · required

Carrier identifier within Chameleoon Delivery

Enum values:

ppl

balikovna

status

ContractStatus · enum · required

Lifecycle status of a Chameleoon Delivery contract, and of each carrier within it.

pending — created and still editable, or submitted and awaiting Chameleoon approval (tell the two apart via the contract's submittedAt)
active — approved by Chameleoon and usable
suspended — temporarily disabled by Chameleoon
deactivated — permanently disabled

Enum values:

pending

active

suspended

deactivated

statusChangedAt

string · date-time

When this carrier's status last changed (format yyyy-MM-ddTHH:mm:ss.fff)

activatedAt

string · date-time

When this carrier was activated; null while not yet active

Deactivate a carrier

DELETE

https://api.chameleoon.sk

/v2/chameleoon-delivery/contract/carriers/{courierId}

Deactivates a carrier within the contract.

Deactivate a carrier › path Parameters

courierId

string · enum · required

Carrier identifier to deactivate

Enum values:

ppl

balikovna

Deactivate a carrier › Responses

Carrier deactivated

No data returned

Incidents Webhooks