Submit Transaction Declarations (Batch)

Developing

POST

/api/v1/declarations

Submit Batch Declaration
This endpoint allows institutional clients to submit a batch of transaction declarations for regulatory filing. The system processes the file asynchronously and applies the specified handling strategy for any invalid records.

Request

Header Params

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.geoaccount.com/api/v1/declarations' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxx' \
--header 'GS-API-Key: gs_live_abc123def456789' \
--header 'GS-Timestamp: 1710000000' \
--header 'GS-Nonce: 9f8e7d6c5b4a3210' \
--header 'Idempotency-Key: a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8' \
--form 'file=@""' \
--form 'requestId="req_123456789"' \
--form 'invalidOrderHandling="IGNORE"'

Responses

🟢200Success

application/json

Body

Example

{
    "requestId": "REQ_20260305_0001",
    "fileId": " GEOWalletUSD276546757163380736/20260304/2caf9214.csv ",
    "status": "PROCESSING"
}

Modified at 2026-03-27 08:11:13

Transaction Declaration Filing

Query Declaration Processing Result