# What does openai.batch.completed prove?

> Prove that the batch job reached the end. Version 1.0.0, certification Provisional.

Canonical: https://provely.sh/verify/openai/openai.batch.completed  
Last reviewed: 2026-09-05  
Skill version: 0.1.0  
Certification: provisional  

**Prove that the batch job reached the end. The provider ran the batch and the results are ready. This level does not prove that every request inside the batch succeeded. Read openai.batch.all_requests_succeeded for that promise.**

*Contract identity.*

| Fact | Value |
| --- | --- |
| Contract id | `openai.batch.completed` |
| Version | `1.0.0` |
| Hash | `881ad2fb9cce41d8` |
| Completion level | `completed` |
| Publisher | Built and signed by Provely. |
| Certification | Provisional |
| Skill | [OpenAI Platform API 0.1.0](/verify/openai) |
| Valid for provider API versions | `spec_2_3_0` |

## What is the intent?

Run the requests of the input file as one batch job.

## What is the subject and the action?

| Member | Value |
| --- | --- |
| Subject type | `openai.batch` |
| Subject identity | batch_id = `$action.result.id` |
| Canonical effect | `ai.batch_job_start` |
| Provider operation | `POST /batches` |
| Idempotency | none, retry is not safe |

## How does the evidence correlate with this operation?

| Strategy | Assurance | Keys | Required |
| --- | --- | --- | --- |
| `resource_id` | strong | batch_id from `$action.result.id` | yes |
| `fingerprint` | weak | input_file_id from `$input.input_file_id`; endpoint from `$input.endpoint` | no |

## Which evidence does the contract require?

Minimum evidence level `E2`. An independent channel is required. Minimum channels: 1.

| Channel | Level | Independence | Verifier | Description |
| --- | --- | --- | --- | --- |
| `batch_readback` | E2 | provider readback | `http` | Read the batch from the provider. A condition path is $observed.batch_readback.status, and a second one is $observed.batch_readback.request_counts.failed. |
| `batch_completed_events` | E3 | provider event | `webhook` | The batch.completed events of this batch. The payload carries the identifier of the batch and no other member of it, so the count states the end of the job and never the result of one request. The webhook verifier returns {events, count, latest, earliest, types, duplicates_dropped}. |

## Which conditions must all hold for VERIFIED?

| Condition | Meaning | Path | Operator | Expected | Evidence |
| --- | --- | --- | --- | --- | --- |
| `batch_present` | The provider holds the batch with the returned identifier. | `$observed.batch_readback.id` | `eq` | `$action.result.id` | `batch_readback` |
| `batch_status_completed` | The batch reached the status completed. The published table states that the results are ready. | `$observed.batch_readback.status` | `eq` | `completed` | `batch_readback` |
| `batch_input_file_matches` | The batch reads the input file that the intent named. | `$observed.batch_readback.input_file_id` | `eq` | `$input.input_file_id` | `batch_readback` |
| `batch_created_in_window` | The provider created the batch after the operation started. OpenAI writes created_at in seconds since the epoch. | `$observed.batch_readback.created_at` | `time_after` | `$operation.created_at` | `batch_readback` |
| `batch_completed_event` | At least one batch.completed event names this batch. The payload carries the identifier only, so this condition states the end of the job and nothing about one request. | `$observed.batch_completed_events.count` | `gte` | `1` | `batch_completed_events` |

## Which conditions give CONTRADICTED?

| Condition | Class | Reason | Path | Operator | Expected |
| --- | --- | --- | --- | --- | --- |
| `batch_on_wrong_input_file` | wrong subject | The batch reads a different input file than the intent named. | `$observed.batch_readback.input_file_id` | `ne` | `$input.input_file_id` |
| `batch_on_wrong_endpoint` | wrong subject | The batch calls a different endpoint than the intent named. | `$observed.batch_readback.endpoint` | `ne` | `$input.endpoint` |
| `batch_predates_operation` | pre existing state | The batch is older than the operation. It proves nothing. | `$observed.batch_readback.created_at` | `time_before` | `$operation.created_at` |

## Which observed states map to a verdict before completion?

| Rule | Match | Verdict | Reason |
| --- | --- | --- | --- |
| `terminal_failure` | `$observed.batch_readback.status` in `["failed","expired"]` | FAILED | The provider ended the batch without results. Read the errors of the input file. |
| `cancelled` | `$observed.batch_readback.status` eq `"cancelled"` | CONTRADICTED | A person or an agent cancelled the batch. Ask a person before a new batch runs. |
| `still_running` | `$observed.batch_readback.status` in `["validating","in_progress","finalizing","cancelling"]` | PENDING | The batch has not reached a terminal status. The runtime observes again later. |

## How long does the runtime observe?

| Timing member | Value |
| --- | --- |
| Initial delay | 1000 ms |
| Poll interval | 30000 ms |
| Backoff | exponential factor 2, max 900000 ms |
| Maximum attempts | 120 |
| Timeout | 93600000 ms |
| Stale read window | 60000 ms |
| On timeout | UNVERIFIABLE (`evidence_unavailable_before_timeout`), escalated to a person |

## Where do these rules come from?

- `openai.openapi#/paths/~1batches/post`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.openapi#/paths/~1batches/post/responses/200`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.openapi#/components/schemas/Batch/properties/status`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.docs.batch#batch-jobs/the-status-of-a-batch`: [openai.docs.batch](https://platform.openai.com/docs/guides/batch), retrieved 2026-09-09
- `openai.openapi#/components/schemas/Batch/properties/id`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.openapi#/paths/~1batches~1{batch_id}/get/responses/200`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.openapi#/components/schemas/Batch/properties/input_file_id`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.openapi#/components/schemas/CreateBatchRequest/properties/input_file_id`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.openapi#/components/schemas/Batch/properties/created_at`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.events#/events/batch.completed`: [openai.events](https://developers.openai.com/api/reference/resources/webhooks), retrieved 2026-09-09
- `openai.openapi#/components/schemas/WebhookBatchCompleted/properties/data`: [openai.openapi](https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml), retrieved 2026-09-09
- `openai.docs.webhooks#webhooks/the-event-types`: [openai.docs.webhooks](https://platform.openai.com/docs/guides/webhooks), retrieved 2026-09-09

### Can openai.batch.completed return VERIFIED from the action response alone?

No. The minimum evidence level is E2. The action response is E1. The completion conditions read `batch_readback` and `batch_completed_events`.

### What happens after the timeout?

The verdict is UNVERIFIABLE with the reason `evidence_unavailable_before_timeout`. The operation goes to a person for review.

## Read next

- [Read the OpenAI Platform API verification page](https://provely.sh/verify/openai)
- [Read the openai.batch.all_requests_succeeded contract](https://provely.sh/verify/openai/openai.batch.all_requests_succeeded)
- [Read the openai.fine_tuning_job.succeeded contract](https://provely.sh/verify/openai/openai.fine_tuning_job.succeeded)
- [Read what a completion contract contains](https://provely.sh/contracts)
- [Read what a receipt proves](https://provely.sh/docs/receipts)