# POST decrypt titles

API which accepts a list of encrypted titleIds and returns a list of decrypted titleIds (aka Volume/Folios).

Endpoint: POST /orders/v1/titles/decrypt
Version: 1.11.1
Security: oauthClientCredentials

## Header parameters:

  - `customer-id` (string)
    Identifier of the customer this request is on behalf of.

  - `customer-reference` (string)
    Optional description to identify a transaction, used for billing purposes. Note that we'll be providing a separate order ID once the order has been submitted.

  - `x-correlation-id` (string)
    Optional unique UUID which can assist with tracing / debugging requests.
    Example: "824993ab-7366-4faa-963d-c456dec227a5"

  - `idempotency-key` (string)
    Unique UUID used to prevent duplicate order submissions.
This allows requests to be retried after a network failure without accidentally submitting two orders.
If you receive a network error or timeout, you should resend the request with the same idempotency-key.
If you resend a request with the same value for the idempotency-key, you will receive the original response.
If the server is still processing the original POST, you will receive 429 Too Many Requests.
Idempotency keys expire after 24 hours.
    Example: "cc4d91e3-17af-4d11-b333-eb449e62ff07"

## Request fields (application/json):

  - `titleIds` (array, required)
    Example: ["qp0gjuieZ5VzbNKtT/eZvqPryobRkEYxMA==","5JhN+47g1efe+q3uMjyaMiRQ6ySj0844Hg=="]

## Response 200 fields (application/json):

  - `titleIds` (object, required)
    Example: {"qp0gjuieZ5VzbNKtT/eZvqPryobRkEYxMA==":"10940/843","5JhN+47g1efe+q3uMjyaMiRQ6ySj0844Hg==":"11000/100"}

## Response 400 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 401 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 403 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 404 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 429 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 500 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.