Every API here is available over the APIs.io API and to AI agents over MCP.
{
"openapi": "3.1.0",
"info": {
"title": "stax-api",
"version": "0.1"
},
"servers": [
{
"url": "https://apiprod.fattlabs.com/"
}
],
"components": {
"securitySchemes": {
"ApiKeyAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "API key for merchant-level operations. Provides access to merchant-specific endpoints including transactions, payments, customer management, and merchant account settings. This key is scoped to a single merchant account and cannot access partner-level functionality."
},
"PartnerApiKey": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "Partner-level API key with elevated privileges. Grants access to all partner operations including merchant management, portfolio oversight, reporting across multiple merchant accounts, and partner-specific administrative functions. Also provides access to all merchant-level operations for accounts under the partner's management."
},
"EphemeralAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "Temporary authentication token with limited lifespan. Used for short-term access to specific operations, typically generated for secure one-time actions or time-bounded sessions. Automatically expires after a predefined period for enhanced security."
}
}
},
"security": [
{
"ApiKeyAuth": []
}
],
"paths": {
"/query/statement/v3/ach-rejects": {
"get": {
"summary": "ACH Rejections",
"description": "",
"operationId": "ach-rejections",
"parameters": [
{
"name": "startDate",
"in": "query",
"required": true,
"description": "YYYY-MM-DD",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "endDate",
"in": "query",
"required": true,
"description": "YYYY-MM-DD",
"schema": {
"type": "string",
"default": ""
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"data\": [\n {\n \"ach_reject_transaction_id\": \"redacted-transaction-id\",\n \"ach_reject_transaction_created_at\": \"2024-08-23T18:39:39.000Z\",\n \"ach_reject_transaction_amount\": 861.8,\n \"ach_reject_transaction_timing\": \"post_payout\",\n \"original_transaction_id\": \"redacted-original-transaction-id\",\n \"original_transaction_created_at\": \"2024-08-19T16:48:26.000Z\",\n \"original_transaction_amount\": 861.8,\n \"deposit_id\": null,\n \"ach_reject_fee_id\": \"redacted-fee-id\",\n \"ach_reject_fee_amount\": 15,\n \"ach_reject_fee_deducted_at\": \"2024-08-23T11:00:58.000Z\"\n }\n ],\n \"summary\": {\n \"ach_reject_transaction_count\": 1,\n \"ach_reject_transaction_amount\": 861.8,\n \"original_transaction_amount\": 861.8,\n \"ach_reject_fee_amount\": 15\n },\n \"total\": 1,\n \"per_page\": 1000,\n \"current_page\": 1,\n \"last_page\": 1,\n \"next_page_url\": null,\n \"prev_page_url\": null,\n \"from\": 1,\n \"to\": 1\n}"
}
},
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ach_reject_transaction_id": {
"type": "string",
"example": "redacted-transaction-id"
},
"ach_reject_transaction_created_at": {
"type": "string",
"example": "2024-08-23T18:39:39.000Z"
},
"ach_reject_transaction_amount": {
"type": "number",
"example": 861.8,
"default": 0
},
"ach_reject_transaction_timing": {
"type": "string",
"example": "post_payout"
},
"original_transaction_id": {
"type": "string",
"example": "redacted-original-transaction-id"
},
"original_transaction_created_at": {
"type": "string",
"example": "2024-08-19T16:48:26.000Z"
},
"original_transaction_amount": {
"type": "number",
"example": 861.8,
"default": 0
},
"deposit_id": {},
"ach_reject_fee_id": {
"type": "string",
"example": "redacted-fee-id"
},
"ach_reject_fee_amount": {
"type": "integer",
"example": 15,
"default": 0
},
"ach_reject_fee_deducted_at": {
"type": "string",
"example": "2024-08-23T11:00:58.000Z"
}
}
}
},
"summary": {
"type": "object",
"properties": {
"ach_reject_transaction_count": {
"type": "integer",
"example": 1,
"default": 0
},
"ach_reject_transaction_amount": {
"type": "number",
"example": 861.8,
"default": 0
},
"original_transaction_amount": {
"type": "number",
"example": 861.8,
"default": 0
},
"ach_reject_fee_amount": {
"type": "integer",
"example": 15,
"default": 0
}
}
},
"total": {
"type": "integer",
"example": 1,
"default": 0
},
"per_page": {
"type": "integer",
"example": 1000,
"default": 0
},
"current_page": {
"type": "integer",
"example": 1,
"default": 0
},
"last_page": {
"type": "integer",
"example": 1,
"default": 0
},
"next_page_url": {},
"prev_page_url": {},
"from": {
"type": "integer",
"example": 1,
"default": 0
},
"to": {
"type": "integer",
"example": 1,
"default": 0
}
}
}
}
}
},
"400": {
"description": "400",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{}"
}
},
"schema": {
"type": "object",
"properties": {}
}
}
}
}
},
"deprecated": false
}
},
"/file": {
"post": {
"description": "",
"operationId": "post_file",
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"examples": {
"OK": {
"summary": "OK",
"value": {
"merchant_id": "55394e80-826a-4e04-bafa-2e2d615209cf",
"user_id": "0dcb6380-962a-4b9d-b318-81e5625d0316",
"name": "Test Energy Drink Image",
"tag": "generic",
"id": "497da262-d9b3-4d24-920f-25c9c27522b4",
"updated_at": "2025-11-20 20:46:05",
"created_at": "2025-11-20 20:46:05",
"public_url": "https://fattpaydocuments.s3.us-west-2.amazonaws.com/generic/497da262-d9b3-4d24-920f-25c9c27522b4.jpg",
"meta": {
"filesize_bytes": 7384,
"filesize": "7.38 kB",
"extension": "jpg",
"size": {
"width": 225,
"height": 225
},
"mime": "image/jpeg"
}
}
}
}
}
}
}
},
"parameters": [],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name for the file."
},
"tag": {
"type": "string",
"description": "Description to classify the file type (e.g., generic, product-image)."
},
"file": {
"type": "string",
"format": "binary",
"description": "The pathway to the file being uploaded."
}
},
"required": [
"name",
"tag",
"file"
]
},
"examples": {
"New Example": {
"summary": "New Example",
"value": "curl --location 'https://apiprod.fattlabs.com/file' \\\n--header 'Accept: application/json' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer \u2018ey\u2026\u2019 \\\n--form 'name=\"Test Energy Drink Image\"' \\\n--form 'tag=\"generic\"' \\\n--form 'file=@\"/Users/testuser/Downloads/energydrink.jpeg\"'}"
}
}
}
}
}
},
"get": {
"description": "",
"operationId": "get_file",
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"examples": {
"OK": {
"summary": "OK",
"value": {
"current_page": 1,
"data": [
{
"id": "a66bcfb0-8a41-4ef9-99b3-15fe1846bd36",
"merchant_id": "55394e80-826a-4e04-bafa-2e2d615209cf",
"user_id": "5aec6f90-69be-48a5-a419-44ff016f364a",
"name": "Screenshot 2025-11-20 at 2.06.58\u202fPM.png",
"public_url": "https://fattpaydocuments.s3.us-west-2.amazonaws.com/a66bcfb0-8a41-4ef9-99b3-15fe1846bd36.png",
"tag": null,
"meta": {
"filesize_bytes": 139295,
"filesize": "139.3 kB",
"extension": "png",
"size": {
"width": 446,
"height": 496
},
"mime": "image/png"
},
"created_at": "2025-12-01 19:00:08",
"updated_at": "2025-12-01 19:00:08",
"deleted_at": null
},
{
"id": "864ab716-6277-40d8-aed5-271ff878296d",
"merchant_id": "55394e80-826a-4e04-bafa-2e2d615209cf",
"user_id": "5aec6f90-69be-48a5-a419-44ff016f364a",
"name": "",
"public_url": "https://fattpaydocuments.s3.us-west-2.amazonaws.com/itemThumbnail/864ab716-6277-40d8-aed5-271ff878296d.png",
"tag": "itemThumbnail",
"meta": {
"filesize_bytes": 45272,
"filesize": "45.27 kB",
"extension": "png",
"size": {
"width": 222,
"height": 223
},
"mime": "image/png"
},
"created_at": "2025-11-20 21:04:34",
"updated_at": "2025-11-20 21:04:34",
"deleted_at": null
},
{
"id": "497da262-d9b3-4d24-920f-25c9c27522b4",
"merchant_id": "55394e80-826a-4e04-bafa-2e2d615209cf",
"user_id": "0dcb6380-962a-4b9d-b318-81e5625d0316",
"name": "Test Energy Drink Image",
"public_url": "https://fattpaydocuments.s3.us-west-2.amazonaws.com/generic/497da262-d9b3-4d24-920f-25c9c27522b4.jpg",
"tag": "generic",
"meta": {
"filesize_bytes": 7384,
"filesize": "7.38 kB",
"extension": "jpg",
"size": {
"width": 225,
"height": 225
},
"mime": "image/jpeg"
},
"created_at": "2025-11-20 20:46:05",
"updated_at": "2025-11-20 20:46:05",
"deleted_at": null
}
],
"first_page_url": "http://apiprod.fattlabs.com/file?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://apiprod.fattlabs.com/file?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://apiprod.fattlabs.com/file?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://apiprod.fattlabs.com/file",
"per_page": 20,
"prev_page_url": null,
"to": 3,
"total": 3
}
}
}
}
}
}
},
"parameters": []
}
},
"/merchant/{id}/registration/file": {
"post": {
"summary": "Add File to Merchant Registration",
"description": "Uploads a file to a merchant's registration.",
"operationId": "add-file-to-merchant-registration",
"parameters": [
{
"name": "id",
"in": "path",
"schema": {
"type": "string"
},
"required": true,
"description": "ID of the merchant."
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"name",
"file"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the file."
},
"file": {
"type": "string",
"description": "The file itself.",
"format": "binary"
},
"registration_document_id": {
"type": "string",
"description": "Associates the file with a specific registration document."
}
}
}
}
}
},
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"annual_volume\": \"\",\n \"avg_trans_size\": \"\",\n \"b2b_percent\": \"\",\n \"bank_account_type\": \"\",\n \"business_address_1\": \"\",\n \"business_address_2\": \"\",\n \"business_address_city\": \"\",\n \"business_address_country\": \"\",\n \"business_address_state\": \"\",\n \"business_address_zip\": \"\",\n \"business_dba\": \"\",\n \"business_email\": \"\",\n \"business_fax\": \"\",\n \"business_legal_name\": \"\",\n \"business_open_date\": \"\",\n \"business_phone_number\": \"\",\n \"business_tax_id\": \"\",\n \"business_website\": \"\",\n \"card_not_present_percent\": \"\",\n \"card_present_percent\": \"\",\n \"card_swiped_percent\": \"\",\n \"chosen_plan\": \"\",\n \"chosen_processing_method\": \"\",\n \"company_type\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"highest_trans_amount\": \"\",\n \"international\": \"\",\n \"internet\": \"\",\n \"job_title\": \"\",\n \"last_name\": \"\",\n \"location_type\": \"\",\n \"meta\": {\n \"ownership_percentage\": 60,\n \"owner_citizenship\": \"ALA\",\n \"representatives\": [\n {\n \"title\": \"\",\n \"date_of_birth\": \"\",\n \"ssn\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"type\": \"\",\n \"ownership_percentage\": 40,\n \"email\": \"\",\n \"phone\": \"\",\n \"address_1\": \"\",\n \"address_2\": \"\",\n \"address_city\": \"\",\n \"address_state\": \"\",\n \"address_zip\": \"\",\n \"citizenship\": \"ALA\"\n }\n ]\n },\n \"moto_percent\": \"\",\n \"network\": \"\",\n \"owner_address_1\": \"\",\n \"owner_address_2\": \"\",\n \"owner_address_city\": \"\",\n \"owner_address_country\": \"\",\n \"owner_address_state\": \"\",\n \"owner_address_zip\": \"\",\n \"phone_number\": \"\",\n \"plan\": \"\",\n \"principal_owners_name\": \"\",\n \"reason_for_applying\": \"\",\n \"referred_by\": \"\",\n \"refund_policy\": \"\",\n \"seasonal_flag\": false,\n \"seasonal_months\": \"\",\n \"service_you_provide\": \"\",\n \"title\": \"\",\n \"user_dob\": \"\",\n \"merchant_id\": \"791fc3fa-4534-4617-97b6-d41c9e1ce8da\",\n \"user_id\": \"a01a5f74-cbdb-4704-9e9b-56fd5a8ee7b8\",\n \"updated_at\": \"2019-06-19 21:22:03\",\n \"created_at\": \"2019-06-19 21:22:03\",\n \"files\": [\n {\n \"id\": \"69ad5457-c027-4057-ad52-05ef0e39ec39\",\n \"merchant_id\": \"866ccc18-315e-496d-8a49-f16a5da79b75\",\n \"user_id\": \"8f5f7d73-d53c-47c6-8880-6da0de8d9a10\",\n \"name\": \"voidcheck\",\n \"path\": \"onboarding/69ad5457-c027-4057-ad52-05ef0e39ec39.png\",\n \"public_url\": \"https://fattonboardingfiles.s3.us-west-2.amazonaws.com/onboarding/69ad5457-c027-4057-ad52-05ef0e39ec39.png\",\n \"tag\": \"onboarding\",\n \"meta\": {\n \"filesize_bytes\": 2631,\n \"filesize\": \"0.03 kB\",\n \"extension\": \"png\",\n \"size\": {\n \"width\": 225,\n \"height\": 225\n },\n \"mime\": \"image/png\"\n },\n \"created_at\": \"2020-01-16 18:35:03\",\n \"updated_at\": \"2020-01-16 18:35:04\",\n \"deleted_at\": null,\n \"registration_document_id\": \"RD11eb3bbd85936820828f2b181cd9c9d0\"\n }\n ],\n \"electronic_signature\": {\n \"html_content\": \"I agree to...\",\n \"ip\": \"42.1.1.113\",\n \"timestamp\": \"2019-06-19 21:22:03\",\n \"user_id\": \"a01a5f74-cbdb-4704-9e9b-56fd5a8ee7b8\",\n \"email\": \"john@doe.com\",\n \"browser_agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.88 Safari/537.36\"\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"annual_volume": {
"type": "string",
"example": ""
},
"avg_trans_size": {
"type": "string",
"example": ""
},
"b2b_percent": {
"type": "string",
"example": ""
},
"bank_account_type": {
"type": "string",
"example": ""
},
"business_address_1": {
"type": "string",
"example": ""
},
"business_address_2": {
"type": "string",
"example": ""
},
"business_address_city": {
"type": "string",
"example": ""
},
"business_address_country": {
"type": "string",
"example": ""
},
"business_address_state": {
"type": "string",
"example": ""
},
"business_address_zip": {
"type": "string",
"example": ""
},
"business_dba": {
"type": "string",
"example": ""
},
"business_email": {
"type": "string",
"example": ""
},
"business_fax": {
"type": "string",
"example": ""
},
"business_legal_name": {
"type": "string",
"example": ""
},
"business_open_date": {
"type": "string",
"example": ""
},
"business_phone_number": {
"type": "string",
"example": ""
},
"business_tax_id": {
"type": "string",
"example": ""
},
"business_website": {
"type": "string",
"example": ""
},
"card_not_present_percent": {
"type": "string",
"example": ""
},
"card_present_percent": {
"type": "string",
"example": ""
},
"card_swiped_percent": {
"type": "string",
"example": ""
},
"chosen_plan": {
"type": "string",
"example": ""
},
"chosen_processing_method": {
"type": "string",
"example": ""
},
"company_type": {
"type": "string",
"example": ""
},
"email": {
"type": "string",
"example": ""
},
"first_name": {
"type": "string",
"example": ""
},
"highest_trans_amount": {
"type": "string",
"example": ""
},
"international": {
"type": "string",
"example": ""
},
"internet": {
"type": "string",
"example": ""
},
"job_title": {
"type": "string",
"example": ""
},
"last_name": {
"type": "string",
"example": ""
},
"location_type": {
"type": "string",
"example": ""
},
"meta": {
"type": "object",
"properties": {
"ownership_percentage": {
"type": "integer",
"example": 60,
"default": 0
},
"owner_citizenship": {
"type": "string",
"example": "ALA"
},
"representatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"example": ""
},
"date_of_birth": {
"type": "string",
"example": ""
},
"ssn": {
"type": "string",
"example": ""
},
"first_name": {
"type": "string",
"example": ""
},
"last_name": {
"type": "string",
"example": ""
},
"type": {
"type": "string",
"example": ""
},
"ownership_percentage": {
"type": "integer",
"example": 40,
"default": 0
},
"email": {
"type": "string",
"example": ""
},
"phone": {
"type": "string",
"example": ""
},
"address_1": {
"type": "string",
"example": ""
},
"address_2": {
"type": "string",
"example": ""
},
"address_city": {
"type": "string",
"example": ""
},
"address_state": {
"type": "string",
"example": ""
},
"address_zip": {
"type": "string",
"example": ""
},
"citizenship": {
"type": "string",
"example": "ALA"
}
}
}
}
}
},
"moto_percent": {
"type": "string",
"example": ""
},
"network": {
"type": "string",
"example": ""
},
"owner_address_1": {
"type": "string",
"example": ""
},
"owner_address_2": {
"type": "string",
"example": ""
},
"owner_address_city": {
"type": "string",
"example": ""
},
"owner_address_country": {
"type": "string",
"example": ""
},
"owner_address_state": {
"type": "string",
"example": ""
},
"owner_address_zip": {
"type": "string",
"example": ""
},
"phone_number": {
"type": "string",
"example": ""
},
"plan": {
"type": "string",
"example": ""
},
"principal_owners_name": {
"type": "string",
"example": ""
},
"reason_for_applying": {
"type": "string",
"example": ""
},
"referred_by": {
"type": "string",
"example": ""
},
"refund_policy": {
"type": "string",
"example": ""
},
"seasonal_flag": {
"type": "boolean",
"example": false,
"default": true
},
"seasonal_months": {
"type": "string",
"example": ""
},
"service_you_provide": {
"type": "string",
"example": ""
},
"title": {
"type": "string",
"example": ""
},
"user_dob": {
"type": "string",
"examp
# --- truncated at 32 KB (1731 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stax/refs/heads/main/openapi/stax-api-openapi.json