> ## Documentation Index > Fetch the complete documentation index at: https://docs.lucidblock.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Scan job status ## OpenAPI ````yaml /openapi.yaml get /v1/solana/wallets/{wallet}/defi-positions/jobs/{jobId} openapi: 3.1.0 info: title: Lucidblock Positions API version: 0.1.0 summary: >- Read-only Solana DeFi positions with explicit coverage and sourced USD values. description: > For a Solana wallet, returns the lending, liquidity, staking, vault and perpetual positions found by verified protocol adapters, with exact per-leg amounts, sourced USD values and explicit coverage. Conventions: amounts (`amount_raw`) are non-negative base-10 integer strings; `amount` and every USD value are decimal strings; unknown values are `null`, never `"0"`. Times are ISO 8601 UTC with second precision. Addresses are base58 and case-sensitive. Absence of a position is trustworthy only for protocols whose coverage status is `complete`. Totals cover the supported universe only; they are not total wallet net worth. Every `/v1/*` response that passed the rate limiter carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`; a 429 adds `Retry-After`. Every response carries `X-Request-Id`. While `PRIVATE_API_TOKEN` is configured (private alpha), every `/v1/*` route except `/v1/health` requires `Authorization: Bearer `. Snapshots carry display metadata (names, symbols, first-party logo URLs under /assets/v1/, provenance) and a trademark notice: protocol and token names and logos belong to their owners and are shown for identification only (14-metadata.md). Metadata never changes ids, amounts or totals. license: name: Proprietary servers: - url: https://api.lucidblock.xyz description: Production (private alpha until the v1 release gate) security: - {} - AccessToken: [] tags: - name: meta - name: positions - name: catalogue paths: /v1/solana/wallets/{wallet}/defi-positions/jobs/{jobId}: get: tags: - positions summary: Scan job status operationId: getScanJob parameters: - $ref: '#/components/parameters/Wallet' - name: jobId in: path required: true schema: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ responses: '200': description: Job content: application/json: schema: $ref: '#/components/schemas/Job' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '503': $ref: '#/components/responses/Unavailable' components: parameters: Wallet: name: wallet in: path required: true description: Base58 public key decoding to exactly 32 bytes; case-sensitive. schema: $ref: '#/components/schemas/Address' schemas: Job: type: object required: - job_id - wallet - status - attempts - requested_at - started_at - finished_at - next_retry_at - retry_reason - snapshot_id properties: job_id: type: string wallet: $ref: '#/components/schemas/Address' status: $ref: '#/components/schemas/JobStatus' trigger: type: - string - 'null' enum: - kick - cron - admin - canary - null attempts: type: integer requested_at: type: - string - 'null' started_at: type: - string - 'null' finished_at: type: - string - 'null' next_retry_at: type: - string - 'null' retry_reason: type: - string - 'null' snapshot_id: type: - string - 'null' observed_slots: oneOf: - $ref: '#/components/schemas/SlotRange' - type: 'null' errors: type: array maxItems: 20 items: type: object required: - code - adapter properties: code: type: string adapter: type: - string - 'null' message: type: string description: Admin listing only Address: type: string pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ JobStatus: type: string enum: - queued - running - succeeded - failed - partial - expired SlotRange: type: object additionalProperties: false required: - minimum - maximum properties: minimum: type: - integer - 'null' maximum: type: - integer - 'null' ErrorEnvelope: type: object additionalProperties: false required: - error - request_id properties: error: type: object additionalProperties: false required: - code - message properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string details: type: object request_id: type: string ErrorCode: type: string enum: - INVALID_PARAMETER - INVALID_ADDRESS - UNSUPPORTED_PROTOCOL - CURSOR_EXPIRED - UNAUTHORIZED - NOT_FOUND - JOB_NOT_FOUND - METHOD_NOT_ALLOWED - FORBIDDEN - CONFLICT - CONFIG_INVALID - RATE_LIMITED - INTERNAL - DB_UNAVAILABLE - QUEUE_UNAVAILABLE - SNAPSHOT_UNAVAILABLE - SCAN_FAILED - RPC_BUDGET_EXHAUSTED - ASSET_REMOVED responses: BadRequest: description: >- INVALID_PARAMETER, INVALID_ADDRESS, UNSUPPORTED_PROTOCOL or CURSOR_EXPIRED content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Unauthorized: description: UNAUTHORIZED content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' NotFound: description: NOT_FOUND or JOB_NOT_FOUND content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' RateLimited: description: RATE_LIMITED headers: Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Unavailable: description: >- DB_UNAVAILABLE, QUEUE_UNAVAILABLE, SNAPSHOT_UNAVAILABLE, SCAN_FAILED, CONFIG_INVALID or RPC_BUDGET_EXHAUSTED headers: Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' headers: RetryAfter: schema: type: integer minimum: 1 securitySchemes: AccessToken: type: http scheme: bearer description: >- PRIVATE_API_TOKEN, required on /v1/* (except /v1/health) while configured. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.