# BlueTime Orchestra API API

> BlueTime Orchestra API API on Apizie: 43 endpoints (List Custom Forms, Upload a custom form folder (add or replace), Delete a Custom Forms, List Merchants, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/dev-tools:bluetime/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:bluetime`
- Category: Dev Tools
- Status: byok
- Source: https://bluetime.io
- Page: https://zieapi.vercel.app/api/dev-tools/bluetime
- OpenAPI: https://zieapi.vercel.app/api/dev-tools/bluetime/openapi.json

Code Version 1.0.7.15

## Endpoints

### List Custom Forms
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/custom-forms-get-list` (byok)

### Upload a custom form folder (add or replace)
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/custom-forms-upload-form-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The unique name to identify this form in PCI Booking. You will use this value whenever referencing this custom form. |
| body | object | no | JSON request body |

### Delete a Custom Forms
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/custom-forms-remove-form` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The unique identifier provided to this custom form when originally uploaded |

### List Merchants
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-merchants-list-merchants` (byok)

### Get a Merchant
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-merchants-get-merchant-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Name of merchant |

### Set a merchant
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-merchants-update-merchant-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Name of merchant |
| body | object | no | JSON request body |

### Delete a Merchant
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-merchants-remove-merchant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Name of merchant |

### Get a token to start a card operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/card-operations-get-token-start-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ttl | integer | yes | Time to live for the returned token |
| body | object | no | JSON request body |

### Perform card validation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/card-operations-perform-validation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| iin | string | yes | Card prefix |
| body | object | yes | JSON request body |

### Perform Univesal payment gateway charge operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/card-operations-perform-universal-payment-gateway-charge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Tokenize and store card number
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/card-operations-tokenize-and-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Perform validation of the operation using to signed data
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/card-operations-perform-validation-2` (byok)

### Return top credit card brands for lookup of up to 5 first digits. It covers 90% of the cases
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/card-operations-get-top-brands-lookup` (byok)

### Return brand of card prefix.
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/card-operations-get-brand-prefix` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| iin | string | yes | Card prefix |

### Get a token to start a CVV operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/cvv-operations-get-token-cvv-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ttl | integer | yes | Time to live for the returned token |
| body | object | no | JSON request body |

### Perform Univesal payment gateway charge operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/cvv-operations-perform-universal-payment-gateway-charge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Perform validation of the operation using signed data from charge operation
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/cvv-operations-validate-operation` (byok)

### Network-tokenize a card
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/network-token-card-tokenize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Delete a Network-token
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/network-token-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Retrieve Payment Gateway Account
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-accounts-get-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | A unique name of this Payment Gateway Account |

### Add or Replace a Payment Gateway Account
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-accounts-add-or-replace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | A unique name of this Payment Gateway Account |
| body | object | yes | JSON request body |

### Delete a Payment Gateway Account
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-accounts-remove-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | A unique name of this Payment Gateway Account |

### List Payment Gateway Accounts
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-accounts-get-all` (byok)

### List all payment gateways
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-list-gateways` (byok)

### Perform a payment gateway charge operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-perform-charge-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Perform a payment gateway authorize operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-perform-authorize-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Perform a payment gateway capture operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-perform-capture-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Perform a payment gateway refund operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-perform-refund-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Perform a payment gateway Void operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/payment-gateway-void-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get a token to start a card operation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-sessions-get-token-start-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ttl | integer | yes | Time to live for the returned token |
| body | object | no | JSON request body |

### Perform validation of the operation using to signed data
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-sessions-perform-validation-operation` (byok)

### Get challenge ststus, as stored on server
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-sessions-get-challenge-status` (byok)

### Handle a callback (redirect from challenge)
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-sessions-handle-mpi-challenge-callback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| sessionId | string | yes | The value containing data to designate the client |

### Handle a callback (redirect from device fingerprint)
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/three-ds-sessions-handle-fingerprint-callback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| sessionId | string | yes | The value containing data to designate the client |

### Validate Apikey
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/utils-validate-api-key` (byok)

### Brand Lookup
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/tools-get-brand-lookup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| iin | string | yes | Card's BIN / IIN (the first 6 to 11 digits of the card number) |

### Store and tokenize a string
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/string-tokens-store-and-tokenize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Metadata Lookup
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/tools-lookup-metadata` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| iin | string | yes | Card's BIN / IIN (the first 6 to 11 digits of the card number) |

### Retrieve content of StringToken
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/string-tokens-get-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | yes | The token ID of the StringToken you would like to retrieve the content for |

### Delete an existing string by token
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/string-tokens-delete-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | yes | The token ID representing the string to be deleted |

### Retrieve meta data of a StringToken
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/string-tokens-get-meta-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | yes | Token representing the string to be retrieved |

### Card Validation
`POST https://zieapi.vercel.app/v1/dev-tools:bluetime/tools-validate-card-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| iin | string | yes | Card's BIN / IIN (the first 6 to 11 digits of the card number) |
| body | object | yes | JSON request body |

### Luhn Algorithm Validation
`GET https://zieapi.vercel.app/v1/dev-tools:bluetime/tools-validate-luhn-card` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| number | string | yes | The full card number to be validated. |
| metaData | boolean | no | An optional indicator to specify whether the card metadata should be included in the response. |

## Example
```
curl "https://zieapi.vercel.app/v1/dev-tools:bluetime/custom-forms-get-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the BlueTime Orchestra API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/dev-tools:bluetime/custom-forms-get-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the BlueTime Orchestra API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. BlueTime Orchestra API itself also needs your own key from api.epaytools.com.

### Can AI agents use the BlueTime Orchestra API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:bluetime.

### What is the status of the BlueTime Orchestra API API?
Needs your own provider key (bring your own key)