NachoNacho Public API

The NachoNacho Public API allows you to programmatically access the NachoNacho platform.

Server

Server: https://public-api.nachonacho.com

Authentication

Authenticate with the NachoNacho Public API and exchange an API key for a short-lived JWT.

Authentication Operations

• post/auth

Authenticate with API key

Exchange a NachoNacho API key for a short-lived JWT.

Authentication Flow

1. Obtain an API key from your NachoNacho account dashboard (format: NN_live_<key>)
2. Call POST /auth with your API key to receive a short-lived JWT
3. Use that JWT as a Bearer token on all subsequent requests

Body

required
application/json

• apiKey
  Type: string
  required
  Example: NN_live_9W...

Responses

• 200
  JWT token issued successfully
• 401
  Invalid or missing API key

Request Example for post/auth

curl https://public-api.nachonacho.com/auth \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "apiKey": "NN_live_9W..."
}'

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Provisioning

To access these endpoints, you must use a Seller account. Exchange a buyer activation token for a NachoNacho subscription ID, then fetch the related subscription details.

Provisioning Operations

• post/tokens/resolve
• get/subscriptions/{subscriptionId}

NachoPay

NachoPay is a variant of Provisioning for products that are not sold as a fixed recurring plan — usage-based pricing, metered products, variable seat counts, one-off professional services.

NachoPay Operations

• post/tokens/resolve
• get/subscriptions/{subscriptionId}
• post/payments
• post/payments/{paymentId}/refund

Products

Browse NachoNacho marketplace products and product metadata available through the public API.
Note: To access this feature, you must have a Tribe account.

Products Operations

• get/categories
• get/products
• get/products/{productId}