---
title: "List all source strings (POST)"
method: POST
path: "/strings-api/v2/projects/{projectUid}/source-strings"
tags: ["Strings"]
---

# List all source strings (POST)

`POST /strings-api/v2/projects/{projectUid}/source-strings`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/strings-api/v2/projects/{projectUid}/source-strings`
- Auth: HTTP bearer

Returns source strings from Smartling. You can get strings by specifying a file you want strings for, or you can specify individual strings by hashcode.

_If you do not specify at least one of these parameters (`hashcodes` or `fileUri`) no results will be returned._

**Note**: If you use this call to get strings that are not added via the Strings API, you may see differences in the response.

You may see a value for `parsedStringText` but a `null` value for `stringText`. The `stringText` records the raw input received by the Strings API, and therefore will only appear for strings uploaded via the Strings API.
If you are getting a GDN string, the original placeholder values you used will not be returned as these are not saved by Smartling. GDN strings will have placeholders in the format `{0}`, `{1}`, etc.

## Path parameters

- `projectUid` string, required: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

## Request body

- object
  - `hashcodes` Hashcode[]: Hashcodes for each string you want to get source strings for.
  - `fileUri` string: URI path of a source file within a Smartling project.
  - `limit` integer: By default, responses will be limited to 500 per request. This is also the maximum allowed value.
  - `offset` integer: Pagination setting. Default is 0.
  - `showPlaceholderValues` boolean: When `true` (default), placeholder tokens are resolved to display values. When `false`, internal placeholder format (`{0}`, `{1}`, etc.) is preserved.

## Response `200`

OK

- StringResponse
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` object
      - `items` StringInfo[]
        - `hashcode` string: MD5 hash digest — 32 lowercase hexadecimal characters.
        - `keys` object[]: If this string is associated with one or more resource files this is a list of the associated resource keys.
          - `fileUri` string: URI path of a source file within a Smartling project.
          - `key` string: Resource key. `null` if the string does not have a variant.
        - `parsedStringText` string: The text for this string used to define its uniqueness in the Smartling system. This is after placeholders have been processed and escaping normalization has been applied.
        - `stringText` string: The text for this string
        - `stringVariant` string: String variant
        - `maxLength` number: Maximum character length
        - `stringInstructions` string[]: String instructions that were added to the string in the Dashboard.
        - `contentFileStringInstructions` object[]: String instructions that were included in the uploaded file if any.
          - `fileUri` string: URI path of a source file within a Smartling project.
          - `contentFileStringInstruction` string: The text of the instruction.
      - `totalCount` number

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `429`: Too many simultaneous API requests.
- `500`: Unexpected error

## Changes

- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/strings-api/v2/projects/:projectUid/source-strings/post.md)

---

[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.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)