> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.royalti.io/llms.txt > Use this file to discover all available pages before exploring further. # Get delivery status for a message > Get delivery status for a message ## Code Examples ```javascript Node.js theme={null} const response = await fetch('https://api.royalti.io/ddex/delivery/status/example-id', { method: 'GET', }); const data = await response.json(); console.log(data); ``` ```python Python theme={null} import requests response = requests.get( 'https://api.royalti.io/ddex/delivery/status/example-id', ) data = response.json() print(data) ``` ```bash cURL theme={null} curl -X GET https://api.royalti.io/ddex/delivery/status/example-id \ ``` ## OpenAPI ````yaml get /ddex/delivery/status/{messageId} openapi: 3.0.0 info: title: Royalti.io API description: "# Royalti API\r\n\r\nThis is the Royalti music royalty management platform API server.\r\n\r\n## Overview\r\n\r\nThe Royalti API provides comprehensive music royalty management services including:\r\n- Music publishing and writer management\r\n- Royalty processing and analytics\r\n- DDEX integration for music industry standards\r\n- File processing and pattern recognition\r\n- Payment processing and distribution\r\n\r\n## Authentication\r\n\r\nThe API uses JWT-based authentication with multiple protection levels:\r\n- Public endpoints for basic operations\r\n- Protected endpoints requiring valid JWT tokens\r\n- Admin endpoints for administrative functions\r\n\r\n## Features\r\n\r\n- Multi-dimensional royalty analytics\r\n- CWR (Collective Works Registration) support\r\n- DDEX integration for music metadata\r\n- Advanced file processing with pattern recognition\r\n- Real-time data processing with queue system" version: 2.6.0 contact: name: Royalti.io Support email: support@royalti.io url: https://royalti.io license: name: Proprietary url: https://royalti.io/terms servers: - url: https://api.royalti.io description: Production server - url: https://api-dev.royalti.io description: Development server - url: http://localhost:8084 description: Local development security: - bearerAuth: [] tags: - name: Accounting description: Accounting and financial transaction operations - name: DDEX description: DDEX operations (ERN/MEAD, messages, delivery, providers) - name: Label description: Label management operations - name: Internal Webhooks description: Internal system webhooks for royalty processing and downloads - name: Payment Webhooks description: Payment processor webhook endpoints - name: Billing Webhooks description: Stripe billing and subscription webhooks - name: Infrastructure Webhooks description: Cloudflare domain and SSL webhooks - name: Distribution Webhooks description: Digital distribution platform webhooks (FUGA) paths: /ddex/delivery/status/{messageId}: get: tags: - DDEX summary: Get delivery status for a message parameters: - name: messageId in: path required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: object properties: status: type: string data: type: object properties: messageId: type: string deliveryStatus: type: string deliveryAttempts: type: integer lastDeliveryAttempt: type: string format: date-time nullable: true scheduledDeliveryAt: type: string format: date-time nullable: true acknowledgementReceived: type: string format: date-time nullable: true lastDeliveryError: type: string nullable: true queueStatus: type: object nullable: true ernDeliveries: type: array items: $ref: '#/components/schemas/DDEXERNDelivery' statusHistory: type: array items: $ref: '#/components/schemas/DDEXMessageStatus' provider: $ref: '#/components/schemas/DDEXProvider' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: schemas: DDEXERNDelivery: type: object properties: messageId: type: string providerId: type: string deliveryStatus: type: string enum: - pending - delivered - failed - acknowledged deliveryMethod: type: string enum: - SFTP - WebService - API - FTP deliveryAttempts: type: integer deliveredAt: type: string format: date-time nullable: true acknowledgedAt: type: string format: date-time nullable: true errorMessage: type: string nullable: true DDEXMessageStatus: type: object properties: status: type: string enum: - draft - pending - sent - received - acknowledged - failed - rejected statusDate: type: string format: date-time details: type: object nullable: true errorCode: type: string nullable: true errorMessage: type: string nullable: true DDEXProvider: type: object properties: id: type: string format: uuid name: type: string code: type: string dpid: type: string category: type: string enum: - streaming - download - physical - broadcast - sync - other defaultDeliveryMethod: type: string description: Default delivery method example: SFTP deliveryMethods: type: array description: Supported delivery methods items: type: string enum: - SFTP - WebService - API - FTP territories: type: array description: Supported territories (ISO country codes) items: type: string supportedFormats: type: array description: Supported file formats for deliveries items: type: string technicalSpecs: type: object description: Technical specifications and requirements rateLimits: type: object description: Rate limiting configuration acknowledgementSettings: type: object description: Acknowledgement handling configuration description: type: string isActive: type: boolean website: type: string format: uri documentation: type: string format: uri responses: Unauthorized: description: Unauthorized content: application/json: schema: type: object properties: status: type: string example: error message: type: string example: Unauthorized NotFound: description: Not found content: application/json: schema: type: object properties: status: type: string example: error message: type: string example: Resource not found InternalServerError: description: Internal server error content: application/json: schema: type: object properties: status: type: string example: error message: type: string example: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Authorization header using the Bearer scheme. Format: "Bearer {token}" ````