Incidents

Problems reported during picking or packing, or manually in Chameleoon, such as a missing or damaged item or a label that could not be created. Requires the incidents read permission.

Each incident has a problem type and a severity. A critical incident linked to a fulfillment blocks it until the incident is resolved. List the incidents of an order with GET /v2/incidents?orderIds={orderId}.

List incidents

GET

https://api.chameleoon.sk

/v2/incidents

Returns a paginated list of incidents, newest first. Details such as products and activity are not included; use GET /v2/incidents/{id}.

Without a date range, incidents from the last 60 days are returned. A date range can span up to one year. When orderIds is set, the date range is ignored.

List incidents › query Parameters

page

integer · min: 1

Page number for pagination

Default: 1

pageSize

integer · min: 1 · max: 100

Number of items per page

Default: 20

orderIds

string[] · maxItems: 20

Order IDs, up to 20. Repeat the parameter for multiple values. The date range is ignored.

createdFrom

string · date-time

Incidents reported from this date and time, inclusive (format yyyy-MM-ddTHH:mm:ss.fff). Defaults to 60 days before createdTo, or before today. Ignored when orderIds is set.

createdTo

string · date-time

Incidents reported up to this date and time, inclusive (format yyyy-MM-ddTHH:mm:ss.fff). The range can span up to one year.

status

IncidentStatus[]

Incident statuses. Repeat the parameter for multiple values.

Enum values:

open

in_progress

resolved

severity

IncidentSeverity[]

Incident severities. Repeat the parameter for multiple values.

Enum values:

info

warning

critical

blocking

boolean

true returns only incidents that currently block a fulfillment, false returns the rest. Omit to return both.

List incidents › Headers

Accept-Language

string · enum

Language code for localized responses

Enum values:

Default: en

List incidents › Responses

Paginated list of incidents

PagedIncidentListDto

page

integer · required

Current page number

pageSize

integer · required

Number of items per page

totalPages

integer · required

Total number of pages

nextPage

boolean · required

Whether a next page exists

previousPage

boolean · required

Whether a previous page exists

itemsCount

integer · required

Total number of items across all pages

IncidentResponseDto[]

Incidents, newest first. Details such as products and activity are not included; use GET /v2/incidents/{id}.

GET/v2/incidents

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

Example Responses

{
  "page": 1,
  "pageSize": 20,
  "totalPages": 5,
  "nextPage": true,
  "previousPage": false,
  "itemsCount": 95,
  "items": [
    {
      "id": "0192c1d0-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "number": "INC-00042",
      "problemType": {
        "id": "0191d0aa-2b3c-7d4e-8f50-61728394a5b6",
        "name": "Missing item"
      },
      "stage": "picking",
      "kind": "product",
      "severity": "critical",
      "status": "open",
      "blocking": true,
      "source": "mobile_app",
      "orderId": "0192a4c3-9a5f-7e43-bf6d-7a3b4c5d6e7f",
      "fulfillmentId": "0192b7e2-5e3c-7f60-ab43-8c9d0e1f2a3b",
      "pickingId": "0192b7e6-7a8b-7c9d-8e0f-1a2b3c4d5e6f",
      "referenceNumber": "2026000125",
      "disposition": "held",
      "assigned": true,
      "snoozedUntil": "2026-09-12T08:00:00.000",
      "affectedProductCount": 1,
      "missingQuantity": 1,
      "commentCount": 0,
      "createdAt": "2026-09-11T09:14:20.000",
      "statusChangedAt": "2026-09-11T10:02:44.000",
      "resolvedAt": "2026-09-11T10:02:44.000"
    }
  ]
}

json

application/json

Get incident by ID

GET

https://api.chameleoon.sk

/v2/incidents/{id}

Returns an incident with its products, error details and activity.

Get incident by ID › path Parameters

id

string · uuid · required

Unique incident identifier

Get incident by ID › Headers

Accept-Language

string · enum

Language code for localized responses

Enum values:

Default: en

Get incident by ID › Responses

The incident with its products, errors and activity

An incident with its description, products, error details and activity.

IncidentDetailDto

id

string · uuid · required

Unique incident identifier

number

string · required

Incident number

IncidentProblemTypeDto · required

Problem type, as set up in your incident settings

stage

string · enum · required

Warehouse stage the problem relates to

Enum values:

picking

packing

kind

string · enum · required

Kind of problem.

product — an issue with goods, such as a missing or damaged item; see affectedProducts
operation — a process failure, such as a label that could not be created; see operationError

Enum values:

product

operation

severity

IncidentSeverity · enum · required

Severity of an incident.

info — informational
warning — needs attention
critical — blocks the related fulfillment, if there is one, until resolved

Enum values:

info

warning

critical

status

IncidentStatus · enum · required

Status of an incident.

open — reported, not taken yet
in_progress — taken by a team member
resolved — resolved

Enum values:

open

in_progress

resolved

blocking

boolean · required

Whether the incident is currently blocking its fulfillment

source

string · enum · required

Where the incident was reported.

mobile_app — in the Chameleoon mobile app
client_app — in the Chameleoon web app

Enum values:

mobile_app

client_app

assigned

boolean · required

Whether a team member has taken the incident

affectedProductCount

integer · required

Number of entries in affectedProducts

missingQuantity

number · required

Total quantity reported missing, including products already resolved

commentCount

integer · required

Number of comments

createdAt

string · date-time · required

When the incident was reported (format yyyy-MM-ddTHH:mm:ss.fff)

statusChangedAt

string · date-time · required

When the status or assignment last changed (format yyyy-MM-ddTHH:mm:ss.fff)

IncidentProductDto[] · required

Affected products; can be empty

IncidentActivityDto[] · required

Incident history, oldest first

orderId

string · uuid

Related order; null if none

fulfillmentId

string · uuid

Related fulfillment; null if none

pickingId

string · uuid

Picking during which the incident was reported; null if reported outside a picking

referenceNumber

string

Order number

disposition

string · enum

Action the problem type sets for the fulfillment when the incident is critical; null if none.

held — after picking, the fulfillment returns to pending
parked — after picking, the picked items are set aside and the fulfillment moves to picking_staged
left_packing — packing stops and the fulfillment returns to picked

Enum values:

held

parked

left_packing

snoozedUntil

string · date-time

Snoozed until this time; null if not snoozed. A past value means the snooze has ended (format yyyy-MM-ddTHH:mm:ss.fff)

resolvedAt

string · date-time

When the incident was resolved; null until then (format yyyy-MM-ddTHH:mm:ss.fff)

description

string

Note from the person who reported the incident

object

Error details of an operation incident; null for product incidents or when no details were recorded

resolutionMessage

string

Resolution note; null until resolved

GET/v2/incidents/{id}

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

Example Responses

{
  "id": "0192c1d0-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "number": "INC-00042",
  "problemType": {
    "id": "0191d0aa-2b3c-7d4e-8f50-61728394a5b6",
    "name": "Missing item"
  },
  "stage": "picking",
  "kind": "product",
  "severity": "critical",
  "status": "resolved",
  "blocking": false,
  "source": "mobile_app",
  "orderId": "0192a4c3-9a5f-7e43-bf6d-7a3b4c5d6e7f",
  "fulfillmentId": "0192b7e2-5e3c-7f60-ab43-8c9d0e1f2a3b",
  "pickingId": "0192b7e6-7a8b-7c9d-8e0f-1a2b3c4d5e6f",
  "referenceNumber": "2026000125",
  "disposition": "parked",
  "assigned": true,
  "snoozedUntil": null,
  "affectedProductCount": 1,
  "missingQuantity": 1,
  "commentCount": 0,
  "createdAt": "2026-09-11T09:14:20.000",
  "statusChangedAt": "2026-09-11T10:02:44.000",
  "resolvedAt": "2026-09-11T10:02:44.000",
  "description": "Shelf empty, 1 piece missing",
  "affectedProducts": [
    {
      "code": "MUG-WHT",
      "name": "Mug white",
      "measureUnit": "pcs",
      "quantity": 2,
      "missingQuantity": 1,
      "resolved": true,
      "resolvedAt": "2026-09-11T10:02:44.000",
      "resolutionMessage": "Found on the returns shelf"
    }
  ],
  "operationError": null,
  "resolutionMessage": "Found on the returns shelf",
  "activity": [
    {
      "type": "reported",
      "timestamp": "2026-09-11T09:14:20.000"
    },
    {
      "type": "assigned",
      "timestamp": "2026-09-11T09:20:05.000"
    },
    {
      "type": "product_resolved",
      "timestamp": "2026-09-11T10:02:44.000"
    },
    {
      "type": "resolved",
      "timestamp": "2026-09-11T10:02:44.000"
    }
  ]
}

json

application/json

Pickings Chameleoon Delivery

List incidents

GET

https://api.chameleoon.sk

/v2/incidents

Returns a paginated list of incidents, newest first. Details such as products and activity are not included; use GET /v2/incidents/{id}.

Without a date range, incidents from the last 60 days are returned. A date range can span up to one year. When orderIds is set, the date range is ignored.

List incidents › query Parameters

page

integer · min: 1

Page number for pagination

Default: 1

pageSize

integer · min: 1 · max: 100

Number of items per page

Default: 20

orderIds

string[] · maxItems: 20

Order IDs, up to 20. Repeat the parameter for multiple values. The date range is ignored.

createdFrom

string · date-time

Incidents reported from this date and time, inclusive (format yyyy-MM-ddTHH:mm:ss.fff). Defaults to 60 days before createdTo, or before today. Ignored when orderIds is set.

createdTo

string · date-time

Incidents reported up to this date and time, inclusive (format yyyy-MM-ddTHH:mm:ss.fff). The range can span up to one year.

status

IncidentStatus[]

Incident statuses. Repeat the parameter for multiple values.

Enum values:

open

in_progress

resolved

severity

IncidentSeverity[]

Incident severities. Repeat the parameter for multiple values.

Enum values:

info

warning

critical

blocking

boolean

true returns only incidents that currently block a fulfillment, false returns the rest. Omit to return both.

List incidents › Headers

Accept-Language

string · enum

Language code for localized responses

Enum values:

Default: en

List incidents › Responses

Paginated list of incidents

PagedIncidentListDto

page

integer · required

Current page number

pageSize

integer · required

Number of items per page

totalPages

integer · required

Total number of pages

nextPage

boolean · required

Whether a next page exists

previousPage

boolean · required

Whether a previous page exists

itemsCount

integer · required

Total number of items across all pages

IncidentResponseDto[]

Incidents, newest first. Details such as products and activity are not included; use GET /v2/incidents/{id}.

Get incident by ID

GET

https://api.chameleoon.sk

/v2/incidents/{id}

Returns an incident with its products, error details and activity.

Get incident by ID › path Parameters

id

string · uuid · required

Unique incident identifier

Get incident by ID › Headers

Accept-Language

string · enum

Language code for localized responses

Enum values:

Default: en

Get incident by ID › Responses

The incident with its products, errors and activity

An incident with its description, products, error details and activity.

IncidentDetailDto

id

string · uuid · required

Unique incident identifier

number

string · required

Incident number

IncidentProblemTypeDto · required

Problem type, as set up in your incident settings

stage

string · enum · required

Warehouse stage the problem relates to

Enum values:

picking

packing

kind

string · enum · required

Kind of problem.

product — an issue with goods, such as a missing or damaged item; see affectedProducts
operation — a process failure, such as a label that could not be created; see operationError

Enum values:

product

operation

severity

IncidentSeverity · enum · required

Severity of an incident.

info — informational
warning — needs attention
critical — blocks the related fulfillment, if there is one, until resolved

Enum values:

info

warning

critical

status

IncidentStatus · enum · required

Status of an incident.

open — reported, not taken yet
in_progress — taken by a team member
resolved — resolved

Enum values:

open

in_progress

resolved

blocking

boolean · required

Whether the incident is currently blocking its fulfillment

source

string · enum · required

Where the incident was reported.

mobile_app — in the Chameleoon mobile app
client_app — in the Chameleoon web app

Enum values:

mobile_app

client_app

assigned

boolean · required

Whether a team member has taken the incident

affectedProductCount

integer · required

Number of entries in affectedProducts

missingQuantity

number · required

Total quantity reported missing, including products already resolved

commentCount

integer · required

Number of comments

createdAt

string · date-time · required

When the incident was reported (format yyyy-MM-ddTHH:mm:ss.fff)

statusChangedAt

string · date-time · required

When the status or assignment last changed (format yyyy-MM-ddTHH:mm:ss.fff)

IncidentProductDto[] · required

Affected products; can be empty

IncidentActivityDto[] · required

Incident history, oldest first

orderId

string · uuid

Related order; null if none

fulfillmentId

string · uuid

Related fulfillment; null if none

pickingId

string · uuid

Picking during which the incident was reported; null if reported outside a picking

referenceNumber

string

Order number

disposition

string · enum

Action the problem type sets for the fulfillment when the incident is critical; null if none.

held — after picking, the fulfillment returns to pending
parked — after picking, the picked items are set aside and the fulfillment moves to picking_staged
left_packing — packing stops and the fulfillment returns to picked

Enum values:

held

parked

left_packing

snoozedUntil

string · date-time

Snoozed until this time; null if not snoozed. A past value means the snooze has ended (format yyyy-MM-ddTHH:mm:ss.fff)

resolvedAt

string · date-time

When the incident was resolved; null until then (format yyyy-MM-ddTHH:mm:ss.fff)

description

string

Note from the person who reported the incident

object

Error details of an operation incident; null for product incidents or when no details were recorded

resolutionMessage

string

Resolution note; null until resolved