---
search:
  tags:
    - Identity logs
    - POST
seo:
  description: >-
    Add a blocked identity. Requires a Write key. Returns 403 if identity logs
    are… Reference for the POST /identity-logs/blocked endpoint in the scango.ch
    API.
sidebar:
  label: Block identity
  badge: POST
title: Block identity
type: openapi-operation
---
Add a blocked identity. Requires a Write key. Returns 403 if identity logs are not enabled for the organization.

`POST /identity-logs/blocked`

**Request body** (`application/json`, required)

- `comment` (string, required) — Reason for the block. Leading and trailing spaces are trimmed; must not be blank.
- `first_name` (string, required)
- `last_name` (string, required)
- `rawMrz` (string) — Optional machine-readable zone of the scanned document.
- `birthDate` (string) — Optional birth date: \`YYYY-MM-DD\`, or ISO 8601 datetime with \`Z\` or a numeric offset (e.g. \`1990-01-01T00:00:00.000Z\`, \`1990-01-01T12:00:00+02:00\`). Timezone-less datetimes are rejected. Omitted or empty means no birth date is stored.

Request body example:

```json
{
  "comment": "Blocked at door",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "rawMrz": "P<CHELOVELACE<<ADA<<<<<<<<<<<<<<<<<<<",
  "birthDate": "1990-01-01"
}
```

**Responses**

- `200` — Created
- `400` — Invalid parameters or body.
- `403` — API key rejected (see \`Forbidden\`), or identity logs are not enabled for the organization (\`Feature not available\`).

Response example, 200:

```json
{
  "success": true,
  "id": "blk_01"
}
```

Response example, 400:

```json
{
  "statusCode": 400,
  "message": "Validation failed for Field: name, Error: Required",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/suppliers"
}
```

Response example, 403:

```json
{
  "statusCode": 403,
  "message": "Feature not available",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/identity-logs"
}
```