> ## Documentation Index > Fetch the complete documentation index at: https://docs.beltic.com/llms.txt > Use this file to discover all available pages before exploring further. # Submit Document Address > Submit a document for processing (requires at least one uploaded file) ## OpenAPI ````yaml POST /v1/identity/documents/addresses/{id}/submit openapi: 3.1.0 info: title: Beltic Identity API version: 1.0.0 description: >- # Identity API The Beltic Identity API provides identity management capabilities including accounts, sessions, document verification, and identity verifications. ## Key Features - **Account Management**: Create and manage identity accounts - **Session Management**: Create and manage verification sessions with lifecycle controls - **Document Verification**: Submit and process identity documents (government IDs, proof of address) - **Identity Verification**: Run identity, address, and business verifications - **JSON:API Format**: All responses follow JSON:API specification ## Authentication All endpoints require authentication. Include your API key in the `X-Api-Key` header: ``` X-Api-Key: YOUR_API_KEY ``` ## Response Format All responses follow the JSON:API specification for consistent data structures. contact: name: Beltic API Support email: engineering@beltic.com servers: - url: https://api.beltic.com description: Production security: - ApiKeyAuth: [] tags: - name: Accounts description: Account management operations - name: Sessions description: Session management operations - name: Session Devices description: Session device management operations - name: Document Addresses description: Proof of address document management operations - name: Document IDVs description: Government ID verification document management operations - name: Verifications description: Base verification resource operations externalDocs: description: Beltic Platform Documentation url: https://docs.beltic.com paths: /v1/identity/documents/addresses/{id}/submit: post: tags: - Document Addresses summary: Submit document for processing description: Submit a document for processing (requires at least one uploaded file) parameters: - schema: type: string format: uuid description: The unique identifier of the document example: 123e4567-e89b-12d3-a456-426614174000 required: true description: The unique identifier of the document name: id in: path responses: '200': description: Document submitted successfully content: application/json: schema: $ref: '#/components/schemas/DocumentAddressResponse' '400': description: Bad Request - Invalid input data content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found - Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Conflict - Resource already exists content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - ApiKeyAuth: [] components: schemas: DocumentAddressResponse: type: object properties: data: $ref: '#/components/schemas/DocumentAddressResource' meta: type: object properties: presigned_upload_urls: type: array items: type: object properties: file_id: type: string format: uuid description: File ID that matches the file in attributes.files example: 123e4567-e89b-12d3-a456-426614174000 url: type: string format: uri description: Presigned URL for uploading this file to S3 example: https://s3.amazonaws.com/beltic-documents/... expires_in: type: integer exclusiveMinimum: 0 description: Seconds until this presigned URL expires example: 3600 required: - file_id - url - expires_in description: Presigned upload URLs for files (only on create) required: - data ErrorResponse: type: object properties: errors: type: array items: $ref: '#/components/schemas/JsonApiError' meta: type: object additionalProperties: {} required: - errors DocumentAddressResource: type: object properties: id: type: string format: uuid description: Unique identifier for the document example: 123e4567-e89b-12d3-a456-426614174000 type: type: string enum: - document/address description: Resource type attributes: type: object properties: status: type: string enum: - pending - submitted - processed - failed classification_type: type: - string - 'null' is_valid: type: - boolean - 'null' reasoning: type: - string - 'null' name: type: - object - 'null' properties: first: type: - string - 'null' middle: type: - string - 'null' last: type: - string - 'null' document_number: type: - string - 'null' issue_date: type: - string - 'null' expiry_date: type: - string - 'null' issuing_authority: type: - string - 'null' address: type: - object - 'null' properties: line1: type: - string - 'null' line2: type: - string - 'null' city: type: - string - 'null' subdivision: type: - string - 'null' postal_code: type: - string - 'null' country_code: type: - string - 'null' nationality: type: - string - 'null' files: type: array items: $ref: '#/components/schemas/FileInfoResponse' created_at: type: string submitted_at: type: - string - 'null' processed_at: type: - string - 'null' required: - status description: Document attributes relationships: type: object properties: account: type: object properties: data: type: - object - 'null' properties: type: type: string id: type: string required: - type - id required: - data session: type: object properties: data: type: - object - 'null' properties: type: type: string id: type: string required: - type - id required: - data verification: type: object properties: data: type: - object - 'null' properties: type: type: string id: type: string required: - type - id required: - data description: Document relationships required: - id - type - attributes JsonApiError: type: object properties: id: type: string status: type: string code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string parameter: type: string header: type: string meta: type: object additionalProperties: {} required: - status - title - detail FileInfoResponse: type: object properties: id: type: string filename: type: string content_type: type: string byte_size: type: - number - 'null' checksum: type: - string - 'null' status: type: string enum: - pending_upload - uploaded - failed url: type: - string - 'null' format: uri description: >- Presigned download URL (valid for 15 minutes, null if pending upload) example: https://s3.amazonaws.com/...?X-Amz-Signature=... required: - id - filename - content_type - status - url securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: |- API key for authentication. Access https://console.beltic.com/ to obtain your API key. ````