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

# Upload EOB

> Upload a raw EOB file for Lemma to parse and reconcile.

Uploads an Explanation of Benefits (EOB) document for Lemma to parse. Lemma extracts payer, patient, claim, and payment details from the document and uses them for automatic reconciliation against your insurance claims.

Upload the file first using the [Upload file](/api-reference/upload-file) endpoint with purpose `explanation_of_benefits`, then pass the returned `id` here as `file_id`. Lemma will process the document asynchronously.

## Request body

<ParamField body="entity_id" type="string" required>
  The ID of the entity this EOB is for.
</ParamField>

<ParamField body="kind" type="string" required>
  The type of EOB. One of `professional` or `dental`.
</ParamField>

<ParamField body="file_id" type="string" required>
  The ID of a previously uploaded file. Use the [Upload
  file](/api-reference/upload-file) endpoint to obtain one.
</ParamField>

## Response

Returns the created EOB object. The document will be in `processing` status initially.

<ResponseField name="id" type="string">
  Unique identifier for the EOB.
</ResponseField>

<ResponseField name="created_at" type="string">
  [ISO 8601](/api-reference/timestamps) timestamp of when the EOB was uploaded.
</ResponseField>

<ResponseField name="entity_id" type="string">
  The ID of the entity this EOB belongs to.
</ResponseField>

<ResponseField name="kind" type="string">
  The type of EOB. One of `professional` or `dental`.
</ResponseField>

<ResponseField name="status" type="string">
  The processing status of the EOB. One of `processing`, `parsed`, or `failed`.
</ResponseField>

<ResponseField name="file_id" type="string">
  The ID of the uploaded file. Use the [Get PDF](/api-reference/get-pdf)
  endpoint to retrieve a temporary download URL.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "eob_Tm6bXn9hRw3pFk7c",
    "created_at": "2026-03-15T14:30:00Z",
    "entity_id": "entity_k7mXp2vR9nTfBw4s",
    "kind": "professional",
    "status": "processing",
    "file_id": "file_Jd4xVs8mBn2wYh5t"
  }
  ```
</ResponseExample>