**Source URL:** https://limited.veevavault.dev/safety/vault-api/api-reference/18.1/documents/document-locks/retrieve-document-lock-metadata.md

# Retrieve Document Lock Metadata



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

## Headers {#headers}

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

## Request {#request}

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

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "name": "lock",
    "properties": [
        {
            "name": "locked_by__v",
            "scope": "Lock",
            "type": "ObjectReference",
            "required": true,
            "systemAttribute": true,
            "editable": false,
            "setOnCreateOnly": false,
            "disabled": false,
            "objectType": "User",
            "label": "Locked By",
            "hidden": false
        },
        {
            "name": "locked_date__v",
            "scope": "Lock",
            "type": "DateTime",
            "required": true,
            "systemAttribute": true,
            "editable": false,
            "setOnCreateOnly": false,
            "disabled": false,
            "objectType": "DateTime",
            "label": "Locked Date",
            "hidden": false
        }
    ]
}

```
</CodeExample>

## Response Details {#response-details}



---

**Previous:** [Document Locks](/safety/vault-api/api-reference/18.1/documents/document-locks)  
**Next:** [Create Document Lock](/safety/vault-api/api-reference/18.1/documents/document-locks/create-document-lock)