---
title: "Namen durchsuchen (name_scan) mit Blaettern"
method: GET
path: "/v1/names"
tags: ["Namen"]
---

# Namen durchsuchen (name_scan) mit Blaettern

`GET /v1/names`

## Request

- Base URL: `https://doi-api.sendlabs.de` (the document declares no server; this is the origin it was published from)
- URL: `https://doi-api.sendlabs.de/v1/names`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - none

Liefert bis zu count Namen. Die Node sortiert erst nach Namenslaenge, dann nach Bytewert, start (einschliesslich) und after (ausschliesslich) sind Cursor in dieser Reihenfolge, zum Filtern prefix verwenden. Abgelaufene Namen werden standardmaessig uebersprungen, dafuer liest die API bis zu 5000 Eintraege je Aufruf. Zum Weiterblaettern next_after als after uebergeben, bis exhausted true ist. regexp braucht einen write-Schluessel (Backtracking-Ausdruecke koennen die Node lange beschaeftigen).

## Query parameters

- `prefix` string, nullable: Nur Namen mit diesem Praefix, zum Beispiel poe/ oder e/
- `start` string: Cursor: ab diesem Namen (einschliesslich) in der Reihenfolge der Node (Laenge, dann Bytewert)
- `after` string, nullable: Cursor: nach diesem Namen (ausschliesslich) weiterblaettern, ersetzt start. Wert aus next_after uebernehmen
- `count` integer: Gewuenschte Anzahl Treffer, hoechstens 500
- `regexp` string, nullable: Regulaerer Ausdruck auf den Namen (nur mit write-Schluessel, hoechstens 64 Zeichen)
- `min_conf` integer: Mindestbestaetigungen der letzten Operation
- `include_expired` boolean: true: abgelaufene Namen mitliefern
- `value_encoding` string, nullable: ascii, utf8 (Standard) oder hex

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Eingabe fehlerhaft oder von der Node abgelehnt
- `401`: Schluessel fehlt oder ist ungueltig
- `402`: Node-Wallet ohne Guthaben (nur schreibende Aufrufe)
- `403`: Schluesselstufe reicht nicht oder Methode gesperrt
- `404`: Name, Block, Transaktion oder Pfad nicht vorhanden
- `405`: HTTP-Methode fuer diesen Pfad nicht erlaubt
- `409`: Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation
- `413`: Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)
- `422`: JSON-Body oder Parameter passen nicht zum Schema
- `423`: Wallet gesperrt
- `429`: Ratenbegrenzung
- `500`: Interner Fehler der API
- `502`: Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar
- `503`: Node oder ElectrumX nicht erreichbar oder noch nicht synchron
- `504`: Zeitueberschreitung

---

[API](https://skmtc.dev/sendlabs/apis/doichain-api.md) · [All operations](https://skmtc.dev/sendlabs/apis/doichain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sendlabs/apis/doichain-api/revisions/e178cc24ec35?raw)