> For the complete documentation index, see [llms.txt](https://ninja-lender.gitbook.io/ninja-lender-v2-api-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ninja-lender.gitbook.io/ninja-lender-v2-api-en/seller/untitled.md).

# Getting Handbook "Loan Purpose"

**Method:** POST

**Url:** <https://test.ninjalender.online/loan-purpose/list>

**Headers:**

| header\_key   | content                                                   |
| ------------- | --------------------------------------------------------- |
| Content-Type: | application/json;                                         |
| Authorization | Bearer {{Token}}                                          |
| Ninja-Lang    | locale to witch we will translate titles (pl\_PL, en\_GB) |

Where {{Token}} - token obtained during authorization

**Request body:**

| Key | Type | Required | Description |
| --- | ---- | -------- | ----------- |

**Response:**

| Key     | Type        | Description      |
| ------- | ----------- | ---------------- |
| code    | int         | Response code    |
| message | string      | Response message |
| data    | JSON.object | Response data    |

**Data:**

| Key   | Type   | Description           |
| ----- | ------ | --------------------- |
| id    | int    | Id of loan purpose    |
| label | string | name of loan purpose  |
| title | string | title of loan purpose |

**Request example:**

```
{
	
}
```

**Response example:**

**Success:**

```
{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "id": 1,
            "label": "purpose_first",
            "title": "Purpose first"
        },
        {
            "id": 2,
            "label": "purpose_second",
            "title": "Purpose second"
        }
    ],
    "log_key": 750
}
```

&#x20;**Error:**

```
{
    "code": -1,
    "message": "error",
    "log_key": 799,
    "errors": [
        {
            "code": -97,
            "message": "invalid token",
            "log_key": "752"
        }
    ]
}
```

**Error list:**

| Key  | Message       |
| ---- | ------------- |
| -96  | invalid key   |
| -97  | invalid token |
| -98  | expired token |
| -99  | system error  |
| -100 | access denied |