> ## Documentation Index > Fetch the complete documentation index at: https://docs.lumeus.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get transaction header > Returns the indexed header of one transaction: ledger, close time, success, fee charged, operation count and memo. For the envelope, result or meta XDR call RPC `getTransaction` (RPC keeps about 7 days); the decoded events are at `GET /transactions/{hash}/activity`. - An unknown hash returns 404 not_found. On Mainnet that lookup costs the route's minimum credit, because it searched the indexed history; Testnet requests cost no credits. - Unknown or repeated query parameters return 400, so a typo or an unsupported filter never returns unfiltered data. ## OpenAPI ````yaml /api-reference/activity.json get /transactions/{hash} openapi: 3.0.3 info: title: Lumeus Activity API version: '2026-09-15' description: >- Lumeus Activity API on Stellar. Sign up at https://app.lumeus.dev: Free, Starter, Growth and Scale plans are self-serve, Enterprise by agreement. - **Pricing.** Testnet is free: Testnet requests cost no credits and are never billed. Each organization can make 10,000 Testnet requests a day across Activity, Assets and RPC (unlimited on Enterprise); the count resets at 00:00 UTC, and a request over it answers 429 rate_limited with Retry-After set to the seconds until then. Mainnet requests draw from the plan's monthly credits. Plans, limits and credit weights: `GET https://api.lumeus.dev/v1/plans`. - **Authentication.** Send `Authorization: Bearer `. Testnet: `lum_test_…`; Mainnet: `lum_live_…`. A key works only on its own network, so pick the server that matches it (the other network answers 401). Publishable `lum_pub_…` keys call the GET data routes only, from an allowed browser origin. Webhook keys (`whk_…`) are not accepted here. - **Headers.** Every response except `GET /readyz` carries X-Request-Id; authenticated responses carry RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset; 429 and 503 carry Retry-After. - **Errors.** JSON with a machine-readable code (see [errors](/guides/errors)). A path with an empty, `.` or `..` segment answers 400 invalid_request, a trailing slash answers 404 not_found, and a method the path does not accept answers 405 with an Allow header. - **CORS.** Browser calls (CORS) are allowed from https://docs.lumeus.dev (the Try it playground of this reference) and https://app.lumeus.dev only, without cookies; responses expose ETag, Link, Location, Retry-After, X-Request-Id, X-Lumeus-Operation-Id, X-Lumeus-Idempotency and RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (errors included). Other websites cannot read responses made with a server key: use a publishable key with your own allowed origins ([browser keys](/guides/browser-keys)). license: name: Lumeus API contract servers: - url: https://api-testnet.lumeus.dev description: Testnet (default) - url: https://api.lumeus.dev description: Mainnet security: - Bearer: [] tags: - name: Queries description: >- Decoded Stellar history: the token movements and contract events of an account, asset, contract or transaction, the network feed, contract-event topic search and transaction headers. - name: Results description: >- Recover the saved result of a long prepaid request without running it again. Only prepaid accounts receive operation IDs; every other account gets 404 here. - name: Workspace description: >- Your workspace (organization): its name, plan, current period usage and API base URLs. Served by the Activity host for every product. - name: API keys description: >- Create, list, update, rotate and revoke the `lum_` keys used by the Activity API, the Assets API and RPC. - name: Usage description: >- Credits and requests used, the free Testnet daily count, per-route breakdowns, time series and the request log of your keys. - name: Billing description: >- The public plan catalog, plan subscriptions through Stripe Checkout, the billing portal and payment status. - name: Retired description: >- Routes kept only so old clients get a clear answer. Do not use them in new code. - name: Health description: Liveness and readiness probes for monitoring. No authentication. paths: /transactions/{hash}: get: tags: - Queries summary: Get transaction header description: >- Returns the indexed header of one transaction: ledger, close time, success, fee charged, operation count and memo. For the envelope, result or meta XDR call RPC `getTransaction` (RPC keeps about 7 days); the decoded events are at `GET /transactions/{hash}/activity`. - An unknown hash returns 404 not_found. On Mainnet that lookup costs the route's minimum credit, because it searched the indexed history; Testnet requests cost no credits. - Unknown or repeated query parameters return 400, so a typo or an unsupported filter never returns unfiltered data. operationId: getTransactionHeader parameters: - name: hash in: path required: true description: 64-character hexadecimal transaction hash. schema: type: string pattern: ^[0-9a-fA-F]{64}$ example: 1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce x-default: 1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce example: 1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce - name: generation in: query required: false schema: type: string description: >- Index generation (read_view.generation of an earlier page). Send it together with snapshot_ledger. - name: snapshot_ledger in: query required: false schema: type: integer minimum: 1 description: Read at this published snapshot. Requires generation. - name: Idempotency-Key in: header required: false description: >- Optional; reads do not need it. When sent it must be 8 to 128 printable ASCII characters (0x21-0x7E: no spaces or control characters) in one header, otherwise 400. Prepaid accounts use it to recover a read without paying again; for every other account a valid key is accepted and has no effect. schema: type: string minLength: 8 maxLength: 128 pattern: ^[\x21-\x7E]{8,128}$ responses: '200': description: The transaction header. content: application/json: schema: $ref: '#/components/schemas/Transaction' example: _links: activity: href: >- /transactions/1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce/activity self: href: >- /transactions/1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce created_at: '2026-10-22T14:51:32Z' fee_charged: 100 hash: >- 1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce id: >- 1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce ledger: 5331421 memo: '' memo_type: none memo_xdr: '' network: testnet operation_count: 1 paging_token: 0022898278836224000-0000000000 successful: true headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ RateLimit-Limit: description: >- Requests per minute of the bucket that answered: the plan rate, the dashboard session floor of 120, or a publishable key's per-IP rate. schema: type: integer RateLimit-Remaining: description: Whole requests left in the bucket after this one. schema: type: integer RateLimit-Reset: description: Seconds until the bucket is full again. schema: type: integer '400': $ref: '#/components/responses/HTTP400_7' '401': $ref: '#/components/responses/HTTP401' '402': $ref: '#/components/responses/HTTP402' '403': $ref: '#/components/responses/HTTP403' '404': $ref: '#/components/responses/HTTP404_2' '405': $ref: '#/components/responses/HTTP405_7' '409': $ref: '#/components/responses/HTTP409_2' '429': $ref: '#/components/responses/HTTP429' '503': $ref: '#/components/responses/HTTP503' x-codeSamples: - lang: bash label: cURL source: >- curl --fail-with-body -sS 'https://api-testnet.lumeus.dev/transactions/1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce' \ -H "Authorization: Bearer $LUMEUS_API_KEY" - lang: javascript label: JavaScript source: >- // Node 18+ (ES module) const res = await fetch('https://api-testnet.lumeus.dev/transactions/1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce', { method: 'GET', headers: { Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`, }, }); console.log(res.status, JSON.stringify(await res.json(), null, 2)); - lang: python label: Python source: |- import json import os import requests res = requests.get( "https://api-testnet.lumeus.dev/transactions/1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce", headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"}, timeout=30, ) print(res.status_code, json.dumps(res.json(), indent=2)) components: schemas: Transaction: type: object properties: id: type: string pattern: ^[0-9a-fA-F]{64}$ hash: type: string pattern: ^[0-9a-fA-F]{64}$ paging_token: type: string network: type: string enum: - pubnet - testnet ledger: type: integer created_at: type: string format: date-time successful: type: boolean fee_charged: type: integer description: Charged fee in stroops, currently encoded as an integer. operation_count: type: integer memo_type: type: string memo: type: string memo_xdr: type: string _links: type: object properties: self: type: object properties: href: type: string activity: type: object properties: href: type: string required: - id - hash - paging_token - network - ledger - created_at - successful - fee_charged - operation_count - memo_type - memo - memo_xdr - _links Error: type: object properties: error: type: string description: Human-readable message. It may change; branch on code. code: type: string description: >- Machine-readable error code. Branch on code, not on the error text, which may change. RPC carries the same codes as the string error.data of a JSON-RPC error. invalid_request: 400: invalid input, including a malformed Idempotency-Key or an unknown or repeated query parameter (Webhooks also uses it for an oversized request body, 413). Fix the request; do not retry unchanged. unauthorized: 401: missing, revoked, invalid or wrong-network credential. payment_required: 402 (Mainnet): monthly credit quota exhausted on a hard-capped plan. forbidden: 403: the key or account policy does not allow this action. not_found: 404 (Webhooks also 410): the resource does not exist in this organization and network. topic_search_disabled: 404: contract-event topic search is not enabled on this network. method_not_allowed: 405: the route does not accept this method. conflict: 409: conflicting request identity, idempotency key, funding or recovery state. generation_changed: 409: the index generation or network changed since the snapshot was taken; restart the walk without generation and snapshot_ledger. history_unavailable: 409 (Assets): as_of_ledger is not answered from the balance history; start a snapshot job (POST /snapshots) or retry later. precondition_failed: 412 (Webhooks): the subscription version changed; fetch the current ETag. response_too_large: 413: the result exceeds the response budget; lower limit or narrow the request. precondition_required: 428 (Webhooks): If-Match with the subscription ETag is required. rate_limited: 429: a rate, concurrency or credit-cap limit was reached, or (Activity, Assets and RPC on Testnet) the daily Testnet request cap (message `daily Testnet request cap of 10000 reached; resets at 00:00 UTC`, Retry-After until 00:00 UTC). Wait Retry-After seconds (a refused request consumes nothing). A Retry-After greater than 60 means the daily Testnet cap: wait until 00:00 UTC or switch to Mainnet. RPC carries it as the string error.data. internal_error: 500 or another unexpected 5xx; quote request_id when contacting support. not_implemented: 501: the feature is not enabled on this host. busy: 503: reads are saturated (the queue wait expired or the database refused another query or ran short of memory). Retry the same request after Retry-After (2) seconds. query_timeout: 503: the read ran out of time. Do not retry unchanged right away: narrow the ledger range (since_ledger/until_ledger) or lower limit; Retry-After is 30. index_not_ready: 503: the index or snapshot is not ready yet or is rebuilding; retry after Retry-After seconds. topic_coverage: 503: the effective range is outside the contract-event topic index coverage (the message states it); pass a range inside it or retry after Retry-After (60) seconds. unavailable: 503: another temporary failure (billing, rate limiter, queue); retry after Retry-After seconds. enum: - invalid_request - unauthorized - payment_required - forbidden - not_found - topic_search_disabled - method_not_allowed - conflict - generation_changed - history_unavailable - precondition_failed - response_too_large - precondition_required - rate_limited - internal_error - not_implemented - busy - query_timeout - index_not_ready - topic_coverage - unavailable request_id: type: string description: >- Identifier of this request, the same value as the X-Request-Id header. Quote it when contacting support. required: - error responses: HTTP400_7: description: Invalid input, including an unknown or repeated query parameter. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: invalid_request error: >- unknown query parameter "foo"; supported: generation, snapshot_ledger request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ HTTP401: description: >- Missing, invalid, revoked or expired key, or a key for the other network (code unauthorized). Keys work only on the network they were created for. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: unauthorized error: missing credentials request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ HTTP402: description: >- Mainnet only: the plan's monthly credits are used up on a hard-capped plan (Free; code payment_required). Upgrade, or wait for the next period. Testnet requests cost no credits, so Testnet never answers 402. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: payment_required error: >- monthly credit quota exhausted - top up credits or upgrade your plan request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ HTTP403: description: >- This key or account cannot call this route (code forbidden): for example a read-only key on a workspace route, or a publishable key on a route or from an origin it does not allow. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: forbidden error: >- this publishable key requires an Origin header matching one of its allowed origins request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ HTTP404_2: description: >- Unknown hash in this snapshot (code not_found). On Mainnet the lookup costs the route's minimum credit, because it searched the indexed history; Testnet requests cost no credits. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: not_found error: transaction not found request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ HTTP405_7: description: >- This path does not accept the HTTP method you sent (code method_not_allowed). The Allow header lists the methods it accepts. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: method_not_allowed error: >- method POST is not allowed on /transactions/1ae3b48681d8b27f31ee8f1893281e9a56fd7c45cf9909cf6a0599949079c2ce; allowed: GET, HEAD request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ HTTP409_2: description: The index generation changed (code generation_changed). content: application/json: schema: $ref: '#/components/schemas/Error' example: code: generation_changed error: index generation or network changed; restart history sync request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ HTTP429: description: >- A rate or concurrency limit was reached, or on Testnet the organization's daily Testnet request cap (10,000 requests a day across Activity, Assets and RPC); the code is rate_limited for both. Wait Retry-After seconds. A rate_limited answer whose Retry-After is greater than 60 is the daily Testnet cap: wait until 00:00 UTC or switch to Mainnet. A refused request costs nothing and does not count toward the cap. content: application/json: schema: $ref: '#/components/schemas/Error' examples: Daily Testnet cap: summary: 'Daily Testnet request cap (Retry-After: seconds until 00:00 UTC)' value: code: rate_limited error: >- daily Testnet request cap of 10000 reached; resets at 00:00 UTC request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 Plan rate limit: summary: 'Plan rate limit (Retry-After: a few seconds)' value: code: rate_limited error: rate limit exceeded request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ RateLimit-Limit: description: >- Requests per minute of the bucket that answered: the plan rate, the dashboard session floor of 120, or a publishable key's per-IP rate. schema: type: integer RateLimit-Remaining: description: Whole requests left in the bucket after this one. schema: type: integer RateLimit-Reset: description: Seconds until the bucket is full again. schema: type: integer Retry-After: description: Seconds to wait before retrying. schema: type: integer HTTP503: description: >- History not ready for this snapshot (code index_not_ready), reads are saturated (busy), or the read ran out of time or exceeded its own memory limit (query_timeout). Every Activity 503 carries Retry-After. For busy and index_not_ready wait that many seconds (usually 2) and retry the same request; a busy read first queues for up to about 10 seconds before it is refused. For query_timeout (Retry-After 30) narrow the ledger range with since_ledger/until_ledger or lower limit before retrying. content: application/json: schema: $ref: '#/components/schemas/Error' examples: Busy: summary: Reads are saturated (busy, Retry-After 2) value: code: busy error: activity history is busy; retry after the Retry-After delay request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 Query timeout: summary: The read ran out of time (query_timeout, Retry-After 30) value: code: query_timeout error: >- the read exceeded its time limit; narrow the ledger range (since_ledger/until_ledger) or lower limit, then retry request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 History rebuilding: summary: History is rebuilding (index_not_ready, Retry-After 60) value: code: index_not_ready error: activity history is rebuilding request_id: req_6f1c2a9b0e4d4c7a8b3f5e21 headers: X-Request-Id: description: >- Identifier of this request: req_ followed by 24 hex characters. Error bodies repeat it as request_id. Quote it when contacting support. schema: type: string pattern: ^req_[0-9a-f]{24}$ Retry-After: description: >- Seconds to wait before retrying. Present on every Activity 503: 2 for busy or a not-yet-readable snapshot, 30 for query_timeout, 60 while history is rebuilding or outside the topic index coverage. schema: type: integer securitySchemes: Bearer: type: http scheme: bearer description: >- Send `Authorization: Bearer `. Testnet: `lum_test_…`; Mainnet: `lum_live_…`. A key works only on its own network, so pick the server that matches it (the other network answers 401). Publishable `lum_pub_…` keys call the GET data routes only, from an allowed browser origin. Webhook keys (`whk_…`) are not accepted here. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.