Skip to main content
POST
/
v0
/
eobs
Upload EOB
curl --request POST \
  --url https://api.getlemma.com/v0/eobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entity_id": "<string>",
  "kind": "<string>",
  "file_id": "<string>"
}
'
{
  "id": "eob_Tm6bXn9hRw3pFk7c",
  "entity_id": "entity_k7mXp2vR9nTfBw4s",
  "kind": "professional",
  "status": "processing",
  "file_id": "file_Jd4xVs8mBn2wYh5t",
  "created_at": "2026-03-15T14:30:00Z"
}
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 endpoint with purpose explanation_of_benefits, then pass the returned id here as file_id. Lemma will process the document asynchronously.

​
Request body

​
entity_id
string
required
The ID of the entity this EOB is for.
​
kind
string
required
The type of EOB. One of professional or dental.
​
file_id
string
required
The ID of a previously uploaded file. Use the Upload file endpoint to obtain one.

​
Response

Returns the created EOB object. The document will be in processing status initially.
​
id
string
Unique identifier for the EOB.
​
entity_id
string
The ID of the entity this EOB belongs to.
​
kind
string
The type of EOB. One of professional or dental.
​
status
string
The processing status of the EOB. One of processing, parsed, or failed.
​
file_id
string
The ID of the uploaded file. Use the Get PDF endpoint to retrieve a temporary download URL.
​
created_at
string
ISO 8601 timestamp of when the EOB was uploaded.
{
  "id": "eob_Tm6bXn9hRw3pFk7c",
  "entity_id": "entity_k7mXp2vR9nTfBw4s",
  "kind": "professional",
  "status": "processing",
  "file_id": "file_Jd4xVs8mBn2wYh5t",
  "created_at": "2026-03-15T14:30:00Z"
}