---
title: "List string to context bindings"
method: POST
path: "/context-api/v2/projects/{projectId}/bindings/list"
tags: ["Context"]
---

# List string to context bindings

`POST /context-api/v2/projects/{projectId}/bindings/list`

Returns a paginated list of bindings according to specified parameters.

Response is limited to *5000* items, to retrieve all items the request
should be repeated with **offset** parameter specified.

## Path parameters

- `projectId` string, uuid, required

## Query parameters

- `offset` string

## Request body

- BatchBindingsRequest — Parameters for bindings search
  - `stringHashcodes` string[] — List of the hashcodes for the strings to get bindings for.
  - `contentFileUri` string — Content file name to get bindings for.
  - `contextUid` string, uuid — ContextUID to get bindings for.
  - `bindingUids` string[] — List of unique binding identifiers.

## Response `200`

OK

- BindingListResponse
  - `response` object, required
    - `code` 'SUCCESS', required — Indicates whether the response was successful or what error has occured.
    - `data` object
      - `items` Binding[], required
        - `anchors` string[] — Wrapper HTML element anchor numbers
        - `contextPosition` integer — Binding position in context
        - `bindingUid` string — Unique identifier for the context binding.
        - `contextUid` string, required — Unique identifier for the context.
        - `coordinates` Coordinates — Describes the location and size of a box enclosing the string in a context image. ‘top’ and ‘left’ are the distances in pixels of the top left corner of the string (from the top left of the image). ‘width’ and ‘height’ are the dimensions of the string in pixels. This information is used to highlight the position of the string when displaying the context image in the translation interface (CAT tool). If coordinates are not provided, Smartling will attempt to locate the string on the image using Optical Character Recognition. If OCR fails, coordinates will default to 0, 0, 0, 0. This meaans that the image will be displayed when the string is translated, without any highlighting to show the position of the string.
          - `height` number, required
          - `left` number, required
          - `top` number, required
          - `width` number, required
        - `stringHashcode` string, required — Unique identifier for the translatable.
        - `timecode` Timecode — Number of seconds for the period of time that a string appears in a video, relative to the video start time.
          - `endTime` integer
          - `startTime` integer
      - `offset` string — Result set is partial, if not empty. To retreive everything, request should be repeated with offset value.

## Other responses

- `400` — Validation error
- `401` — Provided credentials are not valid.
- `429` — Too many simultaneous API requests.
- `500` — Unexpected error

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) · [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartling/smartling-rest-api-reference/revisions/2a73d11e9b98/schema)