Skip to main content
GET
/
atlantic-query-by-dedup-id
Get Atlantic Query by Dedup ID
curl --request GET \
  --url https://atlantic.api.herodotus.cloud/docs/atlantic-query-by-dedup-id
{
  "atlanticQuery": {
    "id": "<string>",
    "externalId": "<string>",
    "transactionId": "<string>",
    "status": "RECEIVED",
    "step": "<string>",
    "programHash": "<string>",
    "integrityFactHash": "<string>",
    "sharpFactHash": "<string>",
    "layout": "<string>",
    "isFactMocked": true,
    "chain": "L1",
    "jobSize": "XS",
    "declaredJobSize": "XS",
    "cairoVm": "rust",
    "cairoVersion": "cairo0",
    "steps": [
      "<string>"
    ],
    "result": "TRACE_GENERATION",
    "network": "MAINNET",
    "hints": "herodotus_evm_grower",
    "errorReason": "<string>",
    "submittedByClient": "<string>",
    "projectId": "<string>",
    "bucketId": "<string>",
    "bucketJobIndex": -1,
    "customerName": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z",
    "client": {
      "clientId": "<string>",
      "name": "<string>",
      "isEmailVerified": true,
      "email": "<string>",
      "image": "<string>"
    }
  },
  "metadataUrls": [
    "<string>"
  ]
}

​
Query Deduplication

Atlantic supports query deduplication through the dedupId parameter. When submitting a query, you can provide a custom dedupId to:
  • Avoid duplicate processing of identical queries
  • Track and retrieve queries using your own identifier
  • Reference queries across your application consistently
This endpoint allows you to retrieve a query using your custom dedupId and projectId, which is particularly useful when you want to:
  • Ensure idempotent query submissions
  • Retrieve query results using your own tracking identifiers
  • Check if a query with a specific dedup ID already exists before submitting a new one

​
Usage

Provide both the dedupId and projectId as query parameters to retrieve the Atlantic query details.

Query Parameters

​
dedupId
string
required

The deduplication ID used when submitting the query

​
projectId
string
required

The project ID associated with the query

Response

Default Response

​
atlanticQuery
object
required
​
metadataUrls
string[]
required