> ## Documentation Index > Fetch the complete documentation index at: https://developer.ammdistro.com/llms.txt > Use this file to discover all available pages before exploring further. # Submit a transfer > Submits every release in the transfer at once. If any release isn't ready, nothing is submitted and `details` lists each release's problems. A submitted transfer is closed. Needs a key with `delivery:write`. ## OpenAPI ````yaml /api-reference/openapi.json post /delivery/transfers/{transferId}/submit openapi: 3.1.0 info: title: AMM Distro API version: '2026-10-22' description: >- Deliver releases and catalog transfers to AMM Distro from your own systems, check readiness, and follow each release's status. API access is turned on per account by AMM Distro. The account's admins then create keys in **Settings → API**. contact: name: AMM Distro support email: support@ammdistro.com url: https://ammdistro.com servers: - url: https://api.ammdistro.com/api/v2/external description: Production security: - bearerAuth: [] tags: - name: Accounts - name: Releases description: Create, update, validate and submit releases, and read their status. - name: Files description: Upload artwork and audio yourself instead of sending URLs. - name: Catalog transfers description: Move already-released catalog from another distributor. - name: Reference data - name: Ingestion check description: Look up any UPC or ISRC in the account's catalog. paths: /delivery/transfers/{transferId}/submit: post: tags: - Catalog transfers summary: Submit a transfer description: >- Submits every release in the transfer at once. If any release isn't ready, nothing is submitted and `details` lists each release's problems. A submitted transfer is closed. Needs a key with `delivery:write`. operationId: submitTransfer parameters: - name: transferId in: path required: true description: Your ID for the transfer. schema: type: string example: nova-2026-11 - name: accountId in: query required: false description: Required when the key covers more than one account. schema: type: string responses: '200': description: Submitted. content: application/json: schema: type: object properties: submitted: type: integer transfer: $ref: '#/components/schemas/Transfer' '401': description: No key, or a revoked key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing_api_key: value: error: missing_api_key message: 'Send your API key as `Authorization: Bearer `.' invalid_api_key: value: error: invalid_api_key message: API key is invalid or has been revoked. '403': description: The key can't do this, or API access is off for its accounts. content: application/json: schema: $ref: '#/components/schemas/Error' examples: insufficient_scope: value: error: insufficient_scope message: This key does not grant delivery:write. api_access_disabled: value: error: api_access_disabled message: >- API access is not turned on for the accounts this key covers. '404': description: No such release, transfer or account for this key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_found: value: error: not_found message: No release with ID NOVA-004 in this account. '409': description: Closed. content: application/json: schema: $ref: '#/components/schemas/Error' examples: transfer_closed: value: error: transfer_closed message: This transfer was already submitted. '422': description: Not ready. content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_ready: value: error: not_ready message: 2 release(s) in this transfer are not ready. '429': description: >- Rate limit reached. Wait for the time in the `RateLimit-Reset` header. content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limited: value: error: rate_limited message: >- Rate limit of 60 requests per minute exceeded for this key. components: schemas: Transfer: type: object properties: externalId: type: string id: type: string accountId: type: string name: type: - string - 'null' previousDistributor: type: - string - 'null' notes: type: - string - 'null' status: type: string enum: - open - submitted submittedAt: type: - string - 'null' format: date-time totals: type: object properties: releases: type: integer byStatus: type: object additionalProperties: type: integer example: draft: 12 in_review: 3 releases: type: array items: type: object properties: externalId: type: string id: type: string title: type: string upc: type: - string - 'null' status: type: string enum: - draft - in_review - changes_requested - delivering - delivered - live - rejected - taken_down createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object required: - error - message properties: error: type: string description: Stable code to branch on. example: invalid_payload message: type: string description: What happened, in plain words. details: type: array description: >- Per-field problems (payload errors) or per-release problems (transfer submit). items: oneOf: - $ref: '#/components/schemas/PayloadProblem' - $ref: '#/components/schemas/Issue' - $ref: '#/components/schemas/TransferReleaseProblem' PayloadProblem: type: object required: - path - message properties: path: type: string description: Where in your request body the problem is. example: tracks[2].credits[0].roles[1] message: type: string example: '"Wizard" is not a known role (see GET /reference/credit-roles)' Issue: type: object required: - severity - message properties: severity: type: string enum: - error - warning rule: type: string description: Stable rule code, when the problem comes from a release rule. example: credit.production field: type: - string - 'null' example: credits track: type: object description: Which track, when the problem is on one. properties: externalId: type: - string - 'null' discNumber: type: integer trackNumber: type: integer message: type: string TransferReleaseProblem: type: object properties: externalId: type: string errors: type: array items: $ref: '#/components/schemas/Issue' securitySchemes: bearerAuth: type: http scheme: bearer description: An API key from Settings → API in AMM Distro. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.