> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3iq.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Read an encrypted private-inference job.

` GET /v1/api/private-inference/jobs/{job_id} `

Read an encrypted private-inference job.

## Servers

- ` https://b3iq.org ` — Public hosted gateway facade.

## Authentication

The operation accepts these alternatives. Schemes within one alternative are required together.

### Alternative 1

- ` CustomerIDHeader `: ` apiKey `

  - Credential: ` X-B3IQ-Customer-ID ` in ` header `

- ` CustomerTokenHeader `: ` apiKey `

  - Credential: ` X-B3IQ-Customer-Token ` in ` header `

## Parameters

### ` job_id ` (path, required)

- ` value `: type ` string `

  - minLength: ` 1 `

  - maxLength: ` 128 `

## Responses

### ` 200 ` — Private job status and encrypted result fields.

Content type: ` application/json `

- ` value `: type ` object `

  - ` job_id `: type ` string `

  - ` node_id `: type ` string `

  - ` model_id `: type ` string `

  - ` status `: type ` string `

  - ` encrypted_request `: type ` object `

    - Required fields: ` version `, ` key_id `, ` algorithm `, ` client_public_key_x25519 `, ` nonce `, ` ciphertext `

    - ` version `: type ` string `

      - enum: ` ["b3iq-private-transport-v1"] `

    - ` key_id `: type ` string `

    - ` algorithm `: type ` string `

      - enum: ` ["x25519-hkdf-sha256-chacha20poly1305"] `

    - ` client_public_key_x25519 `: type ` string ` — Base64url X25519 client public key.

    - ` nonce `: type ` string ` — Base64url 12-byte AEAD nonce.

    - ` ciphertext `: type ` string ` — Base64url encrypted payload.

    - ` aad_hash `: type ` string ` — Optional sha256 hash of the AAD used when sealing the envelope.

  - ` encrypted_response `: type ` object `

    - Required fields: ` version `, ` key_id `, ` algorithm `, ` client_public_key_x25519 `, ` nonce `, ` ciphertext `

    - ` version `: type ` string `

      - enum: ` ["b3iq-private-transport-v1"] `

    - ` key_id `: type ` string `

    - ` algorithm `: type ` string `

      - enum: ` ["x25519-hkdf-sha256-chacha20poly1305"] `

    - ` client_public_key_x25519 `: type ` string ` — Base64url X25519 client public key.

    - ` nonce `: type ` string ` — Base64url 12-byte AEAD nonce.

    - ` ciphertext `: type ` string ` — Base64url encrypted payload.

    - ` aad_hash `: type ` string ` — Optional sha256 hash of the AAD used when sealing the envelope.

  - ` receipt_hash `: type ` string `

  - ` billing `: type ` unknown ` — Null for free own-machine work; a metering record when the row carries one.

    - ` oneOf alternative 1 `: type ` object `

      - ` customer_id `: type ` string `

      - ` policy_version `: type ` string `

      - ` quoted_price_wei `: type ` string `

      - ` reserved_price_wei `: type ` string `

      - ` payout_price_wei `: type ` string `

      - ` status `: type ` string `

    - ` oneOf alternative 2 `: type ` null `

  - ` webhook `: type ` unknown ` — Null when the job was created without a webhook_url.

    - ` oneOf alternative 1 `: type ` object `

      - ` url `: type ` string `; format ` uri `

      - ` status `: type ` unknown ` — A string value or null.

        - ` anyOf alternative 1 `: type ` string `

        - ` anyOf alternative 2 `: type ` null `

      - ` attempts `: type ` integer `

      - ` last_error `: type ` unknown ` — A string value or null.

        - ` anyOf alternative 1 `: type ` string `

        - ` anyOf alternative 2 `: type ` null `

      - ` next_attempt_at `: type ` unknown `; format ` date-time ` — A string value or null.

        - ` anyOf alternative 1 `: type ` string `

        - ` anyOf alternative 2 `: type ` null `

      - ` last_attempt_at `: type ` unknown `; format ` date-time ` — A string value or null.

        - ` anyOf alternative 1 `: type ` string `

        - ` anyOf alternative 2 `: type ` null `

      - ` delivered_at `: type ` unknown `; format ` date-time ` — A string value or null.

        - ` anyOf alternative 1 `: type ` string `

        - ` anyOf alternative 2 `: type ` null `

    - ` oneOf alternative 2 `: type ` null `

  - ` created_at `: type ` string `; format ` date-time `

  - ` completed_at `: type ` string `; format ` date-time `

### ` default ` — B3IQ-native problem response.

Content type: ` application/json `

- ` value `: type ` object `

  - Required fields: ` error `

  - ` error `: type ` object `

    - Required fields: ` status `, ` title `, ` detail `

    - ` status `: type ` integer `

    - ` title `: type ` string `

    - ` detail `: type ` string `

    - ` code `: type ` string ` — Stable B3IQ code when present. See docs/error-codes.md.

## Request examples

### cURL

```curl
curl -X GET 'https://b3iq.org/v1/api/private-inference/jobs/string' \
  -H 'X-B3IQ-Customer-ID: YOUR_API_KEY'
```

### JavaScript

```javascript
const response = await fetch('https://b3iq.org/v1/api/private-inference/jobs/string', {
  method: 'GET',
  headers: {
      "X-B3IQ-Customer-ID": "YOUR_API_KEY"
  }
});

const data = await response.json();
console.log(data);
```