---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/support/delivery-profile/en/api/express/openapi/IntegrationV2ClaimsJournal.md
  - https://yandex.com/support/delivery-profile/ru/api/express/openapi/IntegrationV2ClaimsJournal.md
  - href: en/api/express/openapi/IntegrationV2ClaimsJournal.md
    type: text/markdown
    title: Markdown version
  - href: ../../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/delivery-profile/en/llms.txt

<div class="openapi">

# Changelog

<!-- markdownlint-disable-file -->

The method returns the change history of the claim. You can find out about the changes in order status and price. For terminal statuses, the "resolution" field is returned, with possible values being ''success'' and ''failed''.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">

<div class="openapi__request">

POST {.openapi__method}
```text translate=no
b2b.taxi.yandex.net/b2b/cargo/integration/v2/claims/journal
```

</div>

Service URL

</div>

</div>

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "cursor": "example"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_cursor_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

A string with the ID of the last change. If the cursor isn't added, all changes with a certain limit will be approved

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

OK

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "cursor": "example",
  "events": [
    {
      "operation_id": 1,
      "claim_id": "3b8d1af142664fde824626a7c19e2bd9",
      "change_type": "status_changed",
      "updated_ts": "2020-01-01T00:00:00+00:00",
      "new_status": "new",
      "new_price": "20.00",
      "new_currency": "RUB",
      "resolution": "success",
      "revision": 1,
      "client_id": "95d010b2471041499b8cb1bfa282692f",
      "current_point_id": 372036854775807
    }
  ]
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_cursor_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Last change ID

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_events_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [Event](#entity-Event)[]

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "operation_id": 1,
    "claim_id": "3b8d1af142664fde824626a7c19e2bd9",
    "change_type": "status_changed",
    "updated_ts": "2020-01-01T00:00:00+00:00",
    "new_status": "new",
    "new_price": "20.00",
    "new_currency": "RUB",
    "resolution": "success",
    "revision": 1,
    "client_id": "95d010b2471041499b8cb1bfa282692f",
    "current_point_id": 372036854775807
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### ClaimStatus {#entity-ClaimStatus}

Claim status. To learn more, see [Status model](https://yandex.com/support/delivery-profile/en/api/express/claim-process.md)

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `new`, `estimating`, `estimating_failed`, `ready_for_approval`, `accepted`, `performer_lookup`, `performer_draft`, `performer_found`, `performer_not_found`, `pickup_arrived`, `ready_for_pickup_confirmation`, `pickuped`, `delivery_arrived`, `ready_for_delivery_confirmation`, `delivered`, `delivered_finish`, `returning`, `return_arrived`, `ready_for_return_confirmation`, `returned`, `returned_finish`, `failed`, `cancelled`, `cancelled_with_payment`, `cancelled_by_taxi`, `cancelled_with_items_on_hands`

</div>

<div class="openapi-entity">

### ClaimStatusResolution {#entity-ClaimStatusResolution}

Terminal status resolution

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `success`, `failed`

</div>

<div class="openapi-entity">

### ClaimPointId {#entity-ClaimPointId}

Integer point ID (int64) generated on the Yandex Delivery side.
It is in the route_points[].id field. Applicable to source, destination, and return points.


**Type**: integer

</div>

<div class="openapi-entity">

### Event {#entity-Event}

Information about the order change

#|
|| **Name** | **Description** ||
||

_change_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Change type. Possible values:
- status_changed — status change. 
- price_changed — price change.


_Example:_{.json-schema-reset .json-schema-example} `status_changed`
{.table-cell}
||
||

_claim_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Claim ID (claim_id)

_Example:_{.json-schema-reset .json-schema-example} `3b8d1af142664fde824626a7c19e2bd9`
{.table-cell}
||
||

_operation_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Operation ID (int64)
{.table-cell}
||
||

_revision_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Claim change version (int64)
{.table-cell}
||
||

_updated_ts_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

Event time in ISO 8601 format

_Example:_{.json-schema-reset .json-schema-example} `2020-01-01T00:00:00+00:00`
{.table-cell}
||
||

_client_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Customer ID

_Example:_{.json-schema-reset .json-schema-example} `95d010b2471041499b8cb1bfa282692f`
{.table-cell}
||
||

_current_point_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [ClaimPointId](#entity-ClaimPointId)

Integer point ID (int64) generated on the Yandex Delivery side.
It is in the route_points[].id field. Applicable to source, destination, and return points.


_Example:_{.json-schema-reset .json-schema-example} `372036854775807`
{.table-cell}
||
||

_new_currency_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Order currency code

_Example:_{.json-schema-reset .json-schema-example} `RUB`
{.table-cell}
||
||

_new_price_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Order price

_Example:_{.json-schema-reset .json-schema-example} `20.00`
{.table-cell}
||
||

_new_status_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [ClaimStatus](#entity-ClaimStatus)

Claim status. To learn more, see [Status model](https://yandex.com/support/delivery-profile/en/api/express/claim-process.md)

_Enum:_{.json-schema-reset .json-schema-value} `new`, `estimating`, `estimating_failed`, `ready_for_approval`, `accepted`, `performer_lookup`, `performer_draft`, `performer_found`, `performer_not_found`, `pickup_arrived`, `ready_for_pickup_confirmation`, `pickuped`, `delivery_arrived`, `ready_for_delivery_confirmation`, `delivered`, `delivered_finish`, `returning`, `return_arrived`, `ready_for_return_confirmation`, `returned`, `returned_finish`, `failed`, `cancelled`, `cancelled_with_payment`, `cancelled_by_taxi`, `cancelled_with_items_on_hands`
{.table-cell}
||
||

_resolution_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [ClaimStatusResolution](#entity-ClaimStatusResolution)

Terminal status resolution

_Enum:_{.json-schema-reset .json-schema-value} `success`, `failed`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "operation_id": 1,
  "claim_id": "3b8d1af142664fde824626a7c19e2bd9",
  "change_type": "status_changed",
  "updated_ts": "2020-01-01T00:00:00+00:00",
  "new_status": "new",
  "new_price": "20.00",
  "new_currency": "RUB",
  "resolution": "success",
  "revision": 1,
  "client_id": "95d010b2471041499b8cb1bfa282692f",
  "current_point_id": 372036854775807
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

BAD REQUEST

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "invalid_cursor",
  "message": "Incorrect cursor format"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Error code

_Const:_{.json-schema-reset .json-schema-value} `invalid_cursor`

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Error description

_Example:_{.json-schema-reset .json-schema-example} `Incorrect cursor format`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__429">

## 429 Too Many Requests

TOO MANY REQUESTS

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "too_many_requests",
  "message": "Too many requests"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Error code

_Const:_{.json-schema-reset .json-schema-value} `too_many_requests`

_Example:_{.json-schema-reset .json-schema-example} `too_many_requests`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Error description

_Example:_{.json-schema-reset .json-schema-example} `Too many requests`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.