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

# 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"></Endpoint>

## Headers {#headers}

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

## URI Path Parameters {#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](/vault-api/api-reference/24.3/vault-objects/merge-object-records/initiate-record-merge) API request or with the [Vault Java SDK](/vault-sdk/entry-points/record-merge/). |
</FieldTable>

## Request {#request}

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

```
</CodeExample>

## Response {#response}

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

```
</CodeExample>

## Response Details {#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](/vault-api/api-reference/24.3/vault-objects/merge-object-records/initiate-record-merge)  
**Next:** [Retrieve Record Merge Results](/vault-api/api-reference/24.3/vault-objects/merge-object-records/retrieve-record-merge-results)