find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/ometria:ometria-translation-requests-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  version: 1.1.0
  title: Ometria data Translation Requests API
  description: 'Welcome to the Ometria API reference.


    The Ometria API is organized around the REST methodology, and it uses resource-oriented URLs, and common HTTP response codes to indicate API errors. All requests are authenticated using an API key which can be obtained from your account settings.


    ### HTTPS


    All requests to the Ometria API MUST be carried out via HTTPS. API servers do not listen on unsecured HTTP ports to avoid the possibility of insecure information exchange.


    ### Message encoding


    The V2 Ometria API uses JSON encoding for all data exchanges and assumes UTF-8 character encoding throughout.


    ### Rate limits


    The Ometria API has a default rate limit of 4 requests per second per Ometria account. The /push/ endpoint allows 8 requests per second per Ometria account. If you expect to exceed this limit, please contact us.


    In the case of your application being rate limited, the HTTP code 429 (too many requests) will be returned. In this case your application should reduce the number of requests it is trying to send.'
  contact:
    name: Ometria
    email: support@ometria.com
    url: https://ometria.com
servers:
- url: https://api.ometria.com/v2
security:
- apikey: []
tags:
- name: Translation Requests
paths:
  /translations/requests:
    get:
      tags:
      - Translation Requests
      summary: List translation requests
      parameters:
      - name: request_id
        in: query
        required: false
        description: The id of the translation request.
        schema:
          type: integer
      - name: status
        in: query
        required: false
        description: Get translation requests that has one of the following statuses.
        schema:
          type: array
          items:
            type: string
            enum:
            - pending
            - cancelled
            - completed
      - name: since_created
        in: query
        required: false
        description: Get translation requests created since this timestamp, in ISO 8601 format.
        schema:
          type: string
          format: date-time
      - name: since_updated
        in: query
        required: false
        description: Get translation requests updated since this timestamp, in ISO 8601 format.
        schema:
          type: string
          format: date-time
      - name: limit
        in: query
        description: The number of records to fetch. Maximum 50.
        required: false
        schema:
          type: integer
          default: 10
      - name: offset
        in: query
        description: The index of the first record to fetch.
        required: false
        schema:
          type: integer
          default: 0
      security:
      - apiKeyReadTranslations: []
      responses:
        '200':
          description: List of translation requests.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TranslationRequest'
        '400':
          description: Invalid request.
        '403':
          description: API key is not authorised to access this resource.
        '500':
          description: An error occurred.
      operationId: getTranslationsRequests
      x-operation-id-source: derived
  /translations/requests/{request_id}:
    get:
      tags:
      - Translation Requests
      summary: Get translation request details
      parameters:
      - name: request_id
        in: path
        required: true
        description: The id of the translation request.
        schema:
          type: integer
      security:
      - apiKeyReadTranslations: []
      responses:
        '200':
          description: Translation request details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TranslationRequestDetails'
        '403':
          description: API key is not authorised to access this resource.
        '404':
          description: Translation request not found.
        '500':
          description: An error occurred.
      operationId: getTranslationsRequestsByRequestId
      x-operation-id-source: derived
  /translations/requests/{request_id}/preview:
    get:
      tags:
      - Translation Requests
      summary: Get translation request template preview in source language
      parameters:
      - name: request_id
        in: path
        required: true
        description: The id of the translation request.
        schema:
          type: integer
      security:
      - apiKeyReadTranslations: []
      responses:
        '200':
          description: Translation request details.
          content:
            text/html:
              schema:
                type: string
        '403':
          description: API key is not authorised to access this resource.
        '404':
          description: Translation request not found.
        '500':
          description: An error occurred.
      operationId: getTranslationsRequestsByRequestIdPreview
      x-operation-id-source: derived
  /translations/submit:
    post:
      tags:
      - Translation Requests
      summary: Submit a translation for a pending translation request
      security:
      - apiKeyWriteTranslations: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TranslationSubmit'
        description: Translation for the pending translation request.
        required: true
      responses:
        '200':
          description: Translation submitted successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              example:
                message: Translations submitted
        '400':
          description: Invalid request.
        '403':
          description: API key is not authorised to access this resource.
        '404':
          description: Translation request not found.
        '500':
          description: An error occurred.
      operationId: postTranslationsSubmit
      x-operation-id-source: derived
components:
  schemas:
    TranslationRequestDetails:
      properties:
        source_lang:
          type: string
          title: Source Language
          description: The language code of the translation source language.
        target_lang:
          type: string
          title: Target Language
          description: The language code of the translation target language.
        source_translations:
          type: object
          title: Source Translations
          description: The source language translations.
        target_translations:
          type: object
          title: Target Translations
          description: The target language translations.
        translation_tags:
          type: array
          items:
            type: string
          title: Translation Tags
          description: The tags that are requested for translation from source to target language.
        created_at:
          type: string
          format: date-time
          title: Created Timestamp
          description: The date and time the translation request was created.
        updated_at:
          type: string
          format: date-time
          title: Updated Timestamp
          description: The date and time the translation request was last updated.
        status:
          type: string
          title: Status
          description: The current status of the translation request.
          enum:
          - pending
          - cancelled
          - completed
      additionalProperties: false
      type: object
      required:
      - source_lang
      - target_lang
      - source_translations
      - target_translations
      - translation_tags
      - created_at
      - updated_at
      - status
      title: TranslationRequestDetails
    TranslationRequest:
      properties:
        request_id:
          type: string
          title: Request ID
          description: The ID of the translation request.
        source_lang:
          type: string
          title: Source Language
          description: The language code of the translation source language.
        target_lang:
          type: string
          title: Target Language
          description: The language code of the translation target language.
        created_at:
          type: string
          format: date-time
          title: Created Timestamp
          description: The date and time the translation request was created.
        updated_at:
          type: string
          format: date-time
          title: Updated Timestamp
          description: The date and time the translation request was last updated.
        status:
          type: string
          title: Status
          description: The current status of the translation request.
          enum:
          - pending
          - cancelled
          - completed
      additionalProperties: false
      type: object
      required:
      - request_id
      - source_lang
      - target_lang
      - created_at
      - updated_at
      - status
      title: TranslationRequest
    TranslationSubmit:
      properties:
        request_id:
          type: integer
          title: Request ID
          description: The ID of the translation request.
        language:
          type: string
          title: Language
          description: The language code of submitted translations.
        translations:
          type: object
          title: Translations
          description: Submitted translations.
      additionalProperties: false
      type: object
      required:
      - language
      - translations
      title: TranslationSubmit
  securitySchemes:
    apikey:
      type: apiKey
      name: X-Ometria-Auth
      in: header
      description: Ometria API key which can be obtained from your Ometria account administrator
    apiKeyReadTranslations:
      type: apiKey
      name: X-Ometria-Auth
      in: header
      description: 'Ometria API key which can be obtained from your Ometria account administrator. **Note**: The API key must have the scope `read:translations`.'
    apiKeyWriteTranslations:
      type: apiKey
      name: X-Ometria-Auth
      in: header
      description: 'Ometria API key which can be obtained from your Ometria account administrator. **Note**: The API key must have the scope `write:translations`.'
x-explorer-enabled: false
x-readme:
  proxy-enabled: true
  samples-enabled: true