**Source URL:** https://limited.veevavault.dev/regulatory/vault-api/api-reference/26.1/documents/document-locks/retrieve-document-lock

# Retrieve Document Lock

<Endpoint path="/api/{version}/objects/documents/{doc_id}/lock" method="GET" />

## Headers

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

## URI Path Parameters

<FieldTable>
| Name | Description |
| --- | --- |
| `{doc_id}` | The document `id` field value. |
</FieldTable>

## Request

<CodeExample title="">
```bash
curl -X GET -H "Authorization: {SESSION_ID}" \
https://myvault.veevavault.com/api/v15.0/objects/documents/534/lock
```
</CodeExample>

## Response

<CodeExample title="">
```json
{
    "responseStatus": "SUCCESS",
    "lock": {
        "locked_by__v": 46916,
        "locked_date__v": "2015-03-20T23:47:11.000Z"
    }
}
```
</CodeExample>

## Response Details

If the document is locked (checked out), the response includes the user `id` field value of the person who checked it out and the date and time. If the document is not locked, the lock fields shown above will not be returned.

---

**Previous:** [Create Document Lock](/regulatory/vault-api/api-reference/26.1/documents/document-locks/create-document-lock)  
**Next:** [Delete Document Lock](/regulatory/vault-api/api-reference/26.1/documents/document-locks/delete-document-lock)