**Source URL:** https://limited.veevavault.dev/safety/vault-api/api-reference/25.3/vault-objects/merge-object-records/retrieve-record-merge-status

# Retrieve Record Merge Status

Given a `job_id` for a merge records job, retrieve the job status.

Before submitting this request:

*   You must have previously requested a record merge job.
*   You must have a valid `job_id` field value returned from the record merge operation.

<Endpoint path="/api/{version}/vobjects/merges/{job_id}/status" method="GET" />

## Headers

<FieldTable>
| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

## URI Path Parameters

<FieldTable>
| Name | Description |
| --- | --- |
| `{job_id}` | The `job_id` field value returned from the merge operation. You can start merge operations with the [Initiate Record Merge](/safety/vault-api/api-reference/25.3/vault-objects/merge-object-records/initiate-record-merge) API request or with the [Vault Java SDK](/safety/vault-sdk/entry-points/record-merge/). |
</FieldTable>

## Request

<CodeExample title="">
```bash
curl -X GET -H "Authorization: {SESSION_ID}" \
https://myvault.veevavault.com/api/v24.1/vobjects/merges/863301/status
```
</CodeExample>

## Response

<CodeExample title="">
```json
{
    "responseStatus": "SUCCESS",
    "data": {
        "status": "IN_PROGRESS"
    }
}
```
</CodeExample>

## Response Details

On `SUCCESS`, the merge job may have one of the following statuses:

*   `IN_PROGRESS`: The job is currently running
*   `SUCCESS`: The job completed with no errors; all records were merged
*   `FAILURE`: The job completed with errors; one or more records were not merged

---

**Previous:** [Initiate Record Merge](/safety/vault-api/api-reference/25.3/vault-objects/merge-object-records/initiate-record-merge)  
**Next:** [Retrieve Record Merge Results](/safety/vault-api/api-reference/25.3/vault-objects/merge-object-records/retrieve-record-merge-results)