Source: https://docs.debitura.com/api/customer-api/users

# Users — Customer API

Base URL: `https://customer-api.debitura.com`

Authentication: `XApiKey` API key; see [authentication](https://docs.debitura.com/developer-concepts/authentication.md).

Generated from [OpenAPI](https://docs.debitura.com/openapi/customer-api.json). Examples are schema illustrations, not observed responses. Complete schemas, including recursive types, are in OpenAPI.

<a id="lists-team-members-belonging-to-the-authenticated-creditor"></a>

## Lists team members belonging to the authenticated creditor.

`GET /users`

Returns a paginated list of users belonging to the authenticated creditor's team.

**Use Case:**
Use this endpoint to retrieve valid user IDs for the `userId` field when sending a chat message via `POST /cases/{id}/chats`.

**Pagination:**
- `page` (default: 1) — Page number, starting from 1
- `pageSize` (default: 50, max: 100) — Number of results per page

**Response:**
Each user entry includes:
- `id` (Guid) — Use this as `userId` in `POST /cases/{id}/chats`
- `name` — Full name of the team member
- `email` — Email address of the team member

### Query parameters

- `Page` (integer): 
- `PageSize` (integer): 

### Response 200

Paginated list of team members returned

- `page` (object, required): Stable v1 pagination metadata shared by public list responses.
- `page.totalResults` (integer): 
- `page.pageSize` (integer): 
- `page.currentPage` (integer): 
- `page.responseCount` (integer): 
- `page.totalPages` (integer): 
- `users` (array of objects, nullable): A user belonging to the authenticated collection partner's team.
Use the Id as the `assignedUserId` when starting a case via POST /cases/{id}/start.
- `users[].id` (uuid): The user's unique ID. Use this as `assignedUserId` in POST /cases/{id}/start.
- `users[].name` (string, nullable): The user's full name.
- `users[].email` (string, nullable): The user's email address.

```json
{
  "page": {
    "totalResults": 42,
    "pageSize": 25,
    "currentPage": 1,
    "responseCount": 42,
    "totalPages": 1
  },
  "users": [
    {
      "id": "3f2b6c1e-8a4d-4b7f-9c2e-5d1a0b9e7f31",
      "name": "Muster GmbH",
      "email": "finance@example.com"
    }
  ]
}
```

### Response 400

Invalid pagination parameters

- `type` (string, nullable): 
- `title` (string, nullable): 
- `status` (integer, nullable): 
- `detail` (string, nullable): 
- `instance` (string, nullable): 

```json
{
  "type": "string",
  "title": "string",
  "status": 3,
  "detail": "string",
  "instance": "string"
}
```

### Response 401

Missing or invalid API key

- `type` (string, nullable): 
- `title` (string, nullable): 
- `status` (integer, nullable): 
- `detail` (string, nullable): 
- `instance` (string, nullable): 

```json
{
  "type": "string",
  "title": "string",
  "status": 3,
  "detail": "string",
  "instance": "string"
}
```

### Response 500

Internal server error

- `type` (string, nullable): 
- `title` (string, nullable): 
- `status` (integer, nullable): 
- `detail` (string, nullable): 
- `instance` (string, nullable): 

```json
{
  "type": "string",
  "title": "string",
  "status": 3,
  "detail": "string",
  "instance": "string"
}
```