---
title: "Get a blocklist entry"
method: GET
path: "/payins-blocklist/{id}"
tags: ["Payins Blocklist"]
---

# Get a blocklist entry

`GET /payins-blocklist/{id}`

## Request

- Base URL: `https://api.shinkansen.finance/v1`
- URL: `https://api.shinkansen.finance/v1/payins-blocklist/{id}`
- Auth: API key in header `Shinkansen-Api-Key`

Returns the blocklist entry with the given ID, scoped to the authenticated fin. Returns 404 if the entry does not exist or belongs to a different fin.

## Path parameters

- `id` integer, required

## Response `200`

Blocklist entry found.

- BlocklistBlock: A single blocklist entry.
  - `id` integer: Unique identifier of the blocklist entry.
  - `criteria` BlocklistBlockCriteria: Matching criteria that identifies an account to block.
    - `creditor` object, required
      - `account_type` string, required: The type of account number (e.g. `clabe`, `cuenta`).
      - `account` string, required: The account number to block.
  - `created_at` string, date-time: ISO 8601 timestamp of when the entry was created.

## Other responses

- `400`: Invalid `id` (not a positive integer).
- `403`: Forbidden (e.g: wrong API Key)
- `404`: Entry not found for the authenticated fin.

---

[API](https://skmtc.dev/shinkansen/apis/payin-transactions-shinkansen-endpoints.md) - [All operations](https://skmtc.dev/shinkansen/apis/payin-transactions-shinkansen-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/shinkansen/apis/payin-transactions-shinkansen-endpoints/revisions/208e04fad4a5?raw)