# Read one obligation

One obligation in full: what is owed and by whom, its type, priority and status, the deal it hangs off, who it is assigned to, the amount in minor units, when it is due, the document type it is waiting on, its SLA clock and breach severity, and the notes against it. An obligation belonging to another workspace answers not found.

Access class: `workspace`.

## Endpoint

`GET /v1/obligations/{id}`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| id | path | string | Yes |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "amountMinor": 1,
    "assignedToUserId": 1,
    "breachSeverity": "string",
    "completedAt": "string",
    "completedByUserId": 1,
    "counterpartyId": 1,
    "createdAt": "string",
    "currency": "string",
    "dealRowId": "",
    "decisionId": 1,
    "description": "string",
    "detail": {},
    "documentId": 1,
    "dueAt": "string",
    "escalatedAt": "string",
    "escalatedToUserId": 1,
    "facilityId": 1,
    "id": 1,
    "isRecurring": true,
    "notes": "string",
    "obligationType": "string",
    "parentObligationId": 1,
    "priority": "string",
    "recurrenceRule": "string",
    "requiredDocumentType": "string",
    "responsibleParty": "string",
    "slaBreachAt": "string",
    "slaHours": 1,
    "status": "string",
    "submissionId": 1,
    "title": "string",
    "updatedAt": "string",
    "waivedAt": "string",
    "waivedByUserId": 1,
    "waivedReason": "string"
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```