> ## Documentation Index
> Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List product translations

> Returns the full translation matrix for the product: the source value and content type per translatable field, plus the translated value for every supported locale.

**Required scope:** `read_products` (for API-key authentication).



## OpenAPI

````yaml /api-reference/admin.yaml get /api/v3/admin/products/{product_id}/translations
openapi: 3.0.3
info:
  title: Admin API
  contact:
    name: Spree Commerce
    url: https://spreecommerce.org
    email: hello@spreecommerce.org
  description: >
    Spree Admin API v3 - Administrative API for managing products, orders, and
    store settings.


    ## Authentication


    The Admin API requires a secret API key passed in the `x-spree-api-key`
    header.

    Secret API keys can be generated in the Spree admin dashboard.


    ## Response Format


    All responses are JSON. List endpoints return paginated responses with
    `data` and `meta` keys.

    Single resource endpoints return a flat JSON object.


    ## Resource IDs


    Every resource is identified by an opaque string ID (e.g. `prod_86Rf07xd4z`,

    `variant_k5nR8xLq`, `or_UkLWZg9DAJ`). Use these IDs everywhere — URL paths,

    request bodies, and Ransack filters all accept them directly.


    ## Error Handling


    Errors return a consistent format:

    ```json

    {
      "error": {
        "code": "validation_error",
        "message": "Validation failed",
        "details": { "name": ["can't be blank"] }
      }
    }

    ```
  version: v3
servers:
  - url: http://{defaultHost}
    variables:
      defaultHost:
        default: localhost:3000
security: []
tags:
  - name: Authentication
    description: Admin user login, logout, token refresh, and current user profile
  - name: Allowed Origins
    description: CORS allowlist for storefront and admin client origins
  - name: API Keys
    description: Secret and publishable API keys
  - name: Channels
    description: Sales channels and product publication across channels
  - name: Custom Fields
    description: >-
      Custom field definitions for products, variants, customers, and other
      resources
  - name: Customer Groups
    description: >-
      Customer groups for segmenting customers (e.g. wholesale, VIP) used by
      pricing and promotions
  - name: Customers
    description: Customer profiles, addresses, credit cards, and store credits
  - name: Exports
    description: Async CSV exports of admin resources
  - name: Fulfillments
    description: Order fulfillments — shipments, fulfill, cancel, resume, split
  - name: Gift Cards
    description: Gift cards and gift card batches
  - name: Markets
    description: >-
      Markets — geographic groupings of countries used for pricing, tax, and
      fulfillment rules
  - name: Option Types
    description: >-
      Option types and option values used to build product variants (e.g. Size,
      Color)
  - name: Orders
    description: Orders, order items, applied gift cards, and applied store credits
  - name: Payment Methods
    description: Configured payment providers and their available types
  - name: Payments
    description: Order payments — list, capture, void
  - name: Pricing
    description: >-
      Prices and price lists for currency-, market-, and customer-group-specific
      pricing
  - name: Products
    description: >-
      Products, taxons/categories, product custom field values, and bulk product
      operations
  - name: Promotions
    description: Promotions, promotion rules, promotion actions, and coupon codes
  - name: Refunds
    description: Order refunds
  - name: Settings
    description: Store-level settings — store profile, tags, store credit categories
  - name: Staff
    description: Admin users, roles, and invitations to the store
  - name: Stock Locations
    description: Warehouses and physical fulfillment locations
  - name: Variants
    description: >-
      Product variants — the individual SKUs (size/color combinations) sold
      under a product
  - name: Webhooks
    description: Webhook endpoints and webhook delivery history
paths:
  /api/v3/admin/products/{product_id}/translations:
    get:
      tags:
        - Products
      summary: List product translations
      description: >-
        Returns the full translation matrix for the product: the source value
        and content type per translatable field, plus the translated value for
        every supported locale.


        **Required scope:** `read_products` (for API-key authentication).
      parameters:
        - name: x-spree-api-key
          in: header
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
        - name: product_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: translations found
          content:
            application/json:
              example:
                data:
                  resource_id: prod_UkLWZg9DAJ
                  resource_type: product
                  translations:
                    de:
                      name: Espressomaschine
                      description: null
                      slug: espressomaschine
                      meta_description: null
                      meta_title: null
                      translated_field_count: 2
                    fr:
                      name: null
                      description: null
                      slug: null
                      meta_description: null
                      meta_title: null
                      translated_field_count: 0
                  fields:
                    - key: name
                      type: string
                      source: Espresso Machine
                    - key: description
                      type: html
                      source: >-
                        Aut vel repellendus architecto rem quos. Non repellendus
                        fugit voluptatum deserunt voluptate distinctio.
                        Perferendis quis ut nam aut. Dolore sed autem esse
                        repudiandae blanditiis ab velit.

                        Ut dicta hic fugit temporibus dignissimos excepturi
                        aspernatur voluptate. Et voluptas maiores voluptate
                        illum temporibus. Ipsum facere magnam deleniti quo quos
                        ea consectetur.

                        Enim veritatis ducimus quaerat saepe facere ullam.
                        Adipisci nostrum deserunt assumenda voluptas numquam
                        perspiciatis. Assumenda quo distinctio atque omnis.
                        Neque dolore tempora culpa repellat. Voluptas nemo amet
                        modi at repellendus consectetur ipsum.

                        Praesentium vitae rerum accusamus quae. Aspernatur eaque
                        soluta quae commodi impedit. Asperiores non eos
                        molestiae culpa.
                    - key: slug
                      type: string
                      source: espresso-machine
                    - key: meta_description
                      type: string
                      source: null
                    - key: meta_title
                      type: string
                      source: null
                  default_locale: en
                  supported_locales:
                    - de
                    - en
                    - fr
      security:
        - api_key: []
          bearer_auth: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      name: x-spree-api-key
      in: header
      description: Secret API key for admin access
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token for admin user authentication

````