Jiko Partner API (Version: fd60d28d)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code

Introduction

Welcome to the Jiko API Reference! Jiko enables you to integrate money storage and movement, backed by the safety and security of US Treasury Bills. Use the Partner API if you are building an application that embeds Jiko’s services and offers Jiko products to your own customers. The Partner API will then enable your application to interact with Jiko on behalf of your customers.

At the core of our platform is the Jiko Pocket: a pair consisting of a bank account and a brokerage account. When money is deposited into a Pocket, the funds are automatically invested in T-bills. When a payment or withdrawal is made, T-bills are immediately liquidated and used as cash. Customers can have multiple Pockets, and each Pocket is associated with a single T-bill maturity: 4-week, 13-week, 26-week or 52-week.

The API Reference covers everything you need to build a full application leveraging the Jiko platform:

Onboarding customers
Funding Pockets via ACH or Wire
Viewing and managing Pockets (including monthly statements and trade confirmations)
Making payments and transfers via ACH, Wire, On-Us (Book) Transfer or Debit Card

When you’re ready to start building, please contact us at partner.support@jiko.io to request sandbox access.

Download OpenAPI description

reference.json

reference.yaml

Servers

Production server

https://{partner}.partner-api.jikoservices.com

Sandbox server

https://{partner}.sandbox-api.jikoservices.com

Accounts

Use these endpoints to view Account information. Jiko Accounts (also known as Pockets) consist of a bank account and a brokerage account. When funds are deposited into a Pocket, they’re immediately invested in T-bills.

In the API interface, the Account object encapsulates both accounts and can be treated as a single account to deposit to or withdraw from.

Operations

Customers

Use these endpoints to view and manage personal details for a Customer.

Operations

Transactions

Use these endpoints to view Transactions of funds moving in and out of Jiko Accounts, specifically the bank account component (cash deposits and withdrawals). For viewing information regarding the brokerage account component (buying and selling of T-bills), use Trades.

Operations

Trades

Use these endpoints to view Trades, or transactions related to the buying and selling of T-bills, within the brokerage account component of Jiko Pockets.

Operations

Statements

Use these endpoints to retrieve monthly statements for bank and brokerage accounts.

Operations

Manage Cards

Use these endpoints to view and manage Card information.

Operations

Physical Cards

Use these endpoints to create, view, and manage Physical Debit Cards.

Operations

Virtual Cards

Use these endpoints to create, view, and manage Virtual Debit Cards.

Operations

Businesses

Use these endpoints to initiate, manage, and complete KYB for Businesses. When an application has status: “APPROVED”, a Customer is created for the Business. Customers can have multiple Pockets.

Operations

Individuals

Use these endpoints to initiate, manage, and complete KYC for Individuals. When an application has status: “APPROVED”, a Customer is created for the Individual. Customers can have multiple Pockets.

Operations

Events

Use these endpoints to view Events.

Operations

Health

Use these endpoints to setup automatic health checks for the Partner API.

Operations

Sandbox

Use these endpoints to initiate sandbox functionality.

Operations

Security

Use these endpoints to authenticate requests to the Jiko API.

Operations

Subscriptions

Use these endpoints to create, view, and manage Subscriptions. Subscriptions provide Partners with the ability to subscribe to Events. Once subscribed, Events will be sent to the specified URL.

Operations

Webhooks

Reports

⚠️ Experimental ⚠️ These endpoints are subject to change.

Use these endpoints to interact with Reports.

Operations

ACH

Use these endpoints to create, view, and manage ACH Transfers.

Operations

Counterparties

Use these endpoints to view Counterparties. Counterparties represent external accounts when moving funds in or out of a Jiko Account. Jiko will only transfer funds between accounts where the Counterparty has status: “VERIFIED”, meaning ownership of the account has been confirmed.

Operations

On-Us Transfers

Use these endpoints to create and view On-Us (Book) Transfers between Jiko accounts.

Operations

Portals

Use these endpoints to create and view Portals. Portals allow third-party financial institutions to initiate ACH and wire transfers. A Portal consists of a routing and an account number. Multiple Portals can be created for a single Pocket.

Operations

Wires

Use this endpoint to initiate Wire Transfers.

Operations

Pockets

Operations

Trading Strategies

Operations

Transactions V2

Operations

Health

Use these endpoints to setup automatic health checks for the Partner API.

Operations

Counterparties V2

Operations

List Counterparties

Request

Retrieve a list of counterparties for a given account.

Security

HTTPBearer

Path

customer_idstring(uuid)(Customer Id)required

Query

cursorCursor (string) or Cursor (null)(Cursor)

Any of:

string(Cursor)

limitinteger(Limit)

Default 100

type(Array of Type ("ach" (any) or "wire" (any) or "on_us" (any) or "international_wire" (any) or "crypto_wallet_address" (any))) or Type (null)(Type)

Any of:

statusArray of Status (strings) or Status (null)(Status)

Any of:

Headers

x-jiko-idempotencystring(uuid)(X-Jiko-Idempotency)required

x-jiko-signaturestring(X-Jiko-Signature)required

curl -i -X GET \
  'https://your-partner-name.partner-api.jikoservices.com/api/v2/customers/{customer_id}/counterparties/?cursor=string&limit=100&type=ach&status=PENDING' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string'

Responses

Successful Response

Bodyapplication/json

prev_pagePrev Page (string) or Prev Page (null)(Prev Page)

Any of:

string(Prev Page)

next_pageNext Page (string) or Next Page (null)(Next Page)

Any of:

string(Next Page)

itemsArray of any(Items)required

items[].idstring(uuid)(Id)required

items[].time_createdstring(date-time)(Time Created)required

items[].statusstring(Status)required

Enum"PENDING""FAILED""LINKED""UNLINKED""CLOSED"

items[].verificationany(Verification)required

items[].verification.idstring(uuid)(Id)required

items[].verification.descriptionDescription (string) or Description (null)(Description)required

Any of:

string(Description)

items[].verification.typeany(Type)required

Discriminator

Value "incoming_wire"

items[].verification.wire_idstring(uuid)(Wire Id)required

items[].verification.statusstring(Status)required

Enum"PENDING_REVIEW""APPROVED""REJECTED"

items[].typeany(Type)required

Discriminator

Value "ach"

items[].counterparty_namestring(Counterparty Name)required

items[].institution_nameInstitution Name (string) or Institution Name (null)(Institution Name)required

Any of:

string(Institution Name)

items[].routing_numberRouting Number (string) or Routing Number (null)(Routing Number)required

Any of:

string(Routing Number)

items[].account_numberAccount Number (string) or Account Number (null)(Account Number)required

Any of:

string(Account Number)

items[].account_typestring(Account Type)required

Enum"CHECKING""SAVINGS"

items[].object_typestring(Object Type)read-onlyrequired

object_typestring(Object Type)

Default "CursorList"

Response

application/json

{
  "prev_page": "cj0xJnA9MjAyMi0xMi0yMSsxNyUzQTIyJTNBMDguNjc5MzQ5JTJCMDAlM0EwMA==",
  "next_page": "cD0yMDIyLTEyLTE5KzE5JTNBNTQlM0EyNy4xODMyNzglMkIwMCUzQTAw",
  "items": [
    { … },
    { … },
    { … }
  ],
  "object_type": "CursorList"
}

Create Counterparty

Request

Creates a counterparty with the provided parameters. There are currently two types of verification available - verification with supporting documents, and with an incoming wire.

Security

HTTPBearer

Path

customer_idstring(uuid)(Customer Id)required

Headers

x-jiko-idempotencystring(uuid)(X-Jiko-Idempotency)required

x-jiko-signaturestring(X-Jiko-Signature)required

Bodyapplication/jsonrequired

Any of:

routing_numberstring(Routing Number)required

identifierstring(Identifier)required

Bank Account Number

identifier_codestring(Identifier Code)required

The code describing the identifier for the counterparty at the counterparty institution.

Enum"SWIFT_BIC""CHIPS_PARTICIPANT""DIRECT_DEPOSIT_ACCOUNT""FED_ROUTING_NUMBER""SWIFT_ID_AND_ACCOUNT_NUMBER""CHIPS_IDENTIFIER""PASSPORT_NUMBER""TAX_IDENTIFICATION_NUMBER""DRIVERS_LICENSE_NUMBER""ALIEN_REGISTRATION_NUMBER"

addressobject(CounterpartyAddress)required

address.street_addressstring(Street Address)<= 250 charactersrequired

Street address

address.street_address2Street Address2 (string) or Street Address2 (null)(Street Address2)

Apartment, Suite, Box number, etc.

Any of:

Apartment, Suite, Box number, etc.

<= 250 characters

string(Street Address2)<= 250 characters

address.citystring(City)<= 250 charactersrequired

City / Town

address.postal_codestring(Postal Code)<= 50 charactersrequired

Postal code / ZIP code

address.statestring(State)required

State (Postal Abbreviations. Example: "AL", "NJ", "OH")

address.countrystring(Country)required

A ISO-3166 Alpha-2 country code (Abbreviated. Example: "US")

wire_instructionsWire Instructions (string) or Wire Instructions (null)(Wire Instructions)

Any additional wire instructions required for the wire to be processed correctly.

Any of:

Any additional wire instructions required for the wire to be processed correctly.

<= 140 characters

string(Wire Instructions)<= 140 characters

counterparty_nameany(Counterparty name)required

counterparty_name.business_namestring(Business Name)required

The name of the business counterparty.

counterparty_name.typeany(Type)required

Discriminator

Value "business"

verificationany(Verification)required

verification.typeany(Type)required

Discriminator

Value "incoming_wire"

verification.wire_idstring(uuid)(Wire Id)required

typeany(Type)required

Value "wire"

curl -i -X POST \
  'https://your-partner-name.partner-api.jikoservices.com/api/v2/customers/{customer_id}/counterparties/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string' \
  -d '{
    "routing_number": "string",
    "identifier": "string",
    "identifier_code": "SWIFT_BIC",
    "address": {
      "street_address": "string",
      "street_address2": "string",
      "city": "string",
      "postal_code": "string",
      "state": "string",
      "country": "string"
    },
    "wire_instructions": "string",
    "counterparty_name": {
      "first_name": "string",
      "last_name": "string",
      "type": "individual"
    },
    "verification": {
      "type": "supporting_documents",
      "document_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ]
    },
    "type": "wire"
  }'

Responses

Successful Response

Bodyapplication/json

idstring(uuid)(Id)required

time_createdstring(date-time)(Time Created)required

statusstring(Status)required

Enum"PENDING""FAILED""LINKED""UNLINKED""CLOSED"

verificationany(Verification)required

verification.idstring(uuid)(Id)required

verification.descriptionDescription (string) or Description (null)(Description)required

Any of:

string(Description)

verification.typeany(Type)required

Discriminator

Value "incoming_wire"

verification.wire_idstring(uuid)(Wire Id)required

verification.statusstring(Status)required

Enum"PENDING_REVIEW""APPROVED""REJECTED"

typeany(Type)required

Discriminator

Value "ach"

counterparty_namestring(Counterparty Name)required

institution_nameInstitution Name (string) or Institution Name (null)(Institution Name)required

Any of:

string(Institution Name)

routing_numberRouting Number (string) or Routing Number (null)(Routing Number)required

Any of:

string(Routing Number)

account_numberAccount Number (string) or Account Number (null)(Account Number)required

Any of:

string(Account Number)

account_typestring(Account Type)required

Enum"CHECKING""SAVINGS"

object_typestring(Object Type)read-onlyrequired

Response

application/json

[
  {
    "id": "86bc2eb3-9b85-4f82-b8fa-91f8d0eea1ff",
    "time_created": "2023-05-11T19:05:01.323339Z",
    "status": "PENDING",
    "verification": { … },
    "type": "wire",
    "counterparty_name": { … },
    "address": { … },
    "institution_name": "External Bank NA",
    "routing_number": "987654321",
    "identifier": "1234567890",
    "identifier_code": "DIRECT_DEPOSIT_ACCOUNT",
    "object_type": "WireCounterpartyV2"
  }
]

Get Counterparty

Request

Security

HTTPBearer

Path

customer_idstring(uuid)(Customer Id)required

counterparty_idstring(uuid)(Counterparty Id)required

Headers

x-jiko-idempotencystring(uuid)(X-Jiko-Idempotency)required

x-jiko-signaturestring(X-Jiko-Signature)required

curl -i -X GET \
  'https://your-partner-name.partner-api.jikoservices.com/api/v2/customers/{customer_id}/counterparties/{counterparty_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string'

Responses

Successful Response

Bodyapplication/json

idstring(uuid)(Id)required

time_createdstring(date-time)(Time Created)required

statusstring(Status)required

Enum"PENDING""FAILED""LINKED""UNLINKED""CLOSED"

verificationany(Verification)required

verification.idstring(uuid)(Id)required

verification.descriptionDescription (string) or Description (null)(Description)required

Any of:

string(Description)

verification.typeany(Type)required

Discriminator

Value "incoming_wire"

verification.wire_idstring(uuid)(Wire Id)required

verification.statusstring(Status)required

Enum"PENDING_REVIEW""APPROVED""REJECTED"

typeany(Type)required

Discriminator

Value "ach"

counterparty_namestring(Counterparty Name)required

institution_nameInstitution Name (string) or Institution Name (null)(Institution Name)required

Any of:

string(Institution Name)

routing_numberRouting Number (string) or Routing Number (null)(Routing Number)required

Any of:

string(Routing Number)

account_numberAccount Number (string) or Account Number (null)(Account Number)required

Any of:

string(Account Number)

account_typestring(Account Type)required

Enum"CHECKING""SAVINGS"

object_typestring(Object Type)read-onlyrequired

Response

application/json

[
  {
    "id": "86bc2eb3-9b85-4f82-b8fa-91f8d0eea1ff",
    "time_created": "2023-05-11T19:05:01.323339Z",
    "status": "LINKED",
    "verification": { … },
    "type": "wire",
    "counterparty_name": { … },
    "address": { … },
    "institution_name": "External Bank NA",
    "routing_number": "987654321",
    "identifier": "1234567890",
    "identifier_code": "DIRECT_DEPOSIT_ACCOUNT",
    "object_type": "WireCounterpartyV2"
  }
]

Introduction

Accounts

Customers

Transactions

Trades

Statements

Manage Cards

Physical Cards

Virtual Cards

Businesses

Individuals

Events

Health

Sandbox

Security

Subscriptions

Webhooks

Reports

ACH

Counterparties

On-Us Transfers

Portals

Wires

Pockets

Trading Strategies

Transactions V2

Health

Counterparties V2

List Counterparties

Request

Responses

Was this helpful?

Create Counterparty

Request

Responses

Was this helpful?

Get Counterparty

Request

Responses

Was this helpful?

Jiko Partner API (Version: fd60d28d)CopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from ClaudeConnect to CursorInstall MCP server on CursorConnect to VS CodeInstall MCP server on VS Code

Introduction

Accounts

Customers

Transactions

Trades

Statements

Manage Cards

Physical Cards

Virtual Cards

Businesses

Individuals

Events

Health

Sandbox

Security

Subscriptions

Webhooks

Reports

ACH

Counterparties

On-Us Transfers

Portals

Wires

Pockets

Trading Strategies

Transactions V2

Health

Counterparties V2

List Counterparties

RequestExpand all

Responses

Was this helpful?

Create Counterparty

RequestExpand all

Responses

Was this helpful?

Get Counterparty

Request

Responses

Was this helpful?

Request

Request