Skip to main content
Use the identities command to list people and organizations on Core, inspect one profile by ID, and register new identities interactively. Link identities to balances when you need a customer or counterparty on a ledger.
CommandAliasDescription
listlBrowse and filter identities; add --id for one record
createcRegister an individual or organization via prompts

​
list

Search and page through individuals and organizations on Core. Filter on indexed profile fields (email, first name, last name, and others) to find the identity_id you will use when linking balances. 
blnk identities list [options]
Options
OptionTypeDefaultDescription
--{field}string—Filter by any indexed field (for example --email-address jane@example.com).
-p, --pageinteger1Page number.
--per-pageinteger10Results per page.
-h, --helpboolean—Show help for this command.
Usage
1

List all identities

Run the command to view a paginated table of identities:
blnk identities list
Filter and paginate:
blnk identities list --page 2 --per-page 20
blnk identities list --email-address jane@example.com
blnk identities list --first-name Jane --last-name Doe
200 Success
┌────────────────   ──────────   ──────────   ─────────────────────────────────   ───────────────────────────┐
│ Identity ID      │ First Name │ Last Name  │ Email Address                     │ Created At                  │
| ---------------- | ---------- | ---------- | --------------------------------- | --------------------------- |
│ idt_8ff119a1...  │ N/A        │ N/A        │ contact@northwind-traders.example │ 2026-05-23T13:42:16.547035Z │
│ idt_9f21736f...  │ N/A        │ N/A        │ accounts@pacific-rim.example      │ 2026-05-23T13:42:15.344356Z │
│ idt_20e8d4f3...  │ Wei        │ Lin        │ wei.lin@example.com               │ 2026-05-23T13:42:14.258165Z │
└────────────────   ──────────   ──────────   ─────────────────────────────────   ───────────────────────────┘
20 results found
Page 1/2

​
list --id

Fetch one identity by identity_id with type, contact fields, and timestamps in a summary block. Pass --json to include address fields, phone, and full meta_data in the output. 
blnk identities list --id <identity-id> [options]
Options
OptionTypeRequiredDescription
--idstringYesIdentity ID to fetch (for example idt_8ff119a1-9103-487c-ae07-1449583fb126).
--jsonbooleanNoPrint the full API object as JSON instead of a formatted summary.
-h, --helpbooleanNoShow help for this command.
Usage
1

Get one identity

Run the command with an identity ID:
blnk identities list --id idt_8ff119a1-9103-487c-ae07-1449583fb126

Identity details:
  identity_id: idt_8ff119a1-9103-487c-ae07-1449583fb126
  identity_type: organization
  first_name: N/A
  last_name: N/A
  email_address: contact@northwind-traders.example
  created_at: 2026-05-23T13:42:16Z

​
create

Register a new individual or organization through interactive prompts for type, name, email, and optional metadata. Use this for manual onboarding or smoke tests. The fields mirror what you send to the Core identities API. 
blnk identities create [options]
Arguments The CLI prompts for these values. They are not passed on the command line.
ArgumentTypeRequiredDescription
identity_typestringYesIdentity type (for example individual or organization). Prompt: identity type >
first_namestringYesFirst name. Prompt: first name >
last_namestringYesLast name. Prompt: last name >
email_addressstringYesEmail address. Prompt: email >
meta_dataobjectNoOptional metadata as JSON. Prompt: metadata (json) >. Press Enter to skip.
Options
OptionTypeDescription
--jsonbooleanAfter a successful create, print the full API response as JSON.
-h, --helpbooleanShow help for this command.
Usage
1

Create new identity

Run the command:
blnk identities create
The CLI prompts for each argument:
identity type >
first name >
last name >
email >
metadata (json) >
Press Enter at the metadata prompt to leave it empty.
2

Identity created

Identity created:
  identity_id: idt_abc123
  identity_type: individual
  first_name: Jane
  last_name: Doe
  email_address: jane@example.com
  created_at: 2026-05-23T17:07:49Z