Courier tracking links

The method returns courier tracking links.

Request

GET

b2b.taxi.yandex.net/b2b/cargo/integration/v2/claims/tracking-links

Service URL

Query parameters

Name

Description

claim_id

Type: string

Claim ID received at the claim creation stage

Min length: 32

Max length: 64

Example: ``

Responses

200 OK

Courier tracking links

Body

application/json

{
  "route_points": [
    {
      "id": 1,
      "type": "source",
      "visit_order": 1,
      "sharing_link": "example"
    }
  ]
}

Name

Description

route_points

Type: PointWithSharingLink[]

Route points with tracking links

Example

[
  {
    "id": 1,
    "type": "source",
    "visit_order": 1,
    "sharing_link": "example"
  }
]

PointType

Point type:

source: the point of departure where the courier picks up the item
destination: destination points where the courier delivers the items
return: item return point (added automatically and matches the point of departure by default, but a different point can also be selected)

Type: string

Enum: source, destination, return

PointWithSharingLink

Name	Description
id	Type: integer Integer point ID (int64)
type	Type: PointType Point type: source: the point of departure where the courier picks up the item destination: destination points where the courier delivers the items return: item return point (added automatically and matches the point of departure by default, but a different point can also be selected) Enum: `source`, `destination`, `return`
visit_order	Type: integer The order in which the points are visited (numbering starts with 1) (int64)
sharing_link	Type: string Route tracking link. Available only for destination points Example: `example`

Example

{
  "id": 1,
  "type": "source",
  "visit_order": 1,
  "sharing_link": "example"
}

404 Not Found

Claim not found

Body

application/json

{
  "code": "not_found",
  "message": "Claim not found"
}

Name

Description

code

Type: string

Error code

Const: not_found

Example: not_found

message

Type: string

Error description

Example: Claim not found

409 Conflict

Inactive claim or no courier tracking links

Body

application/json

{
  "code": "inappropriate_status",
  "message": "Invalid action regarding the claim"
}

Name

Description

code

Type: string

Error code

Enum: unknown_tracking_links, inappropriate_status

message

Type: string

The person understood the error message

Example: Invalid action regarding the claim

429 Too Many Requests

Too many requests

Body

application/json

{
  "code": "too_many_requests",
  "message": "Too many requests"
}

Name

Description

code

Type: string

Error code

Const: too_many_requests

Example: too_many_requests

message

Type: string

Error description

Example: Too many requests

Was the article helpful?

2.3 Estimated time of arrival

3. Confirmation code