Fire Financial Services Business API

{
  "service_type": "platform",
  "base_url": "https://docs.fire.com",
  "auth_method": "oauth2",
  "auth_config": {
    "grant_type": "client_credentials",
    "token_endpoint": "https://docs.fire.com/reference/authenticate",
    "token_type": "Bearer",
    "token_ttl_seconds": 900,
    "notes": "Access tokens valid for 15 minutes. Multiple concurrent tokens permitted. Requires Fire onboarding via sales team and assigned OAuth client credentials."
  },
  "endpoints": [
    {
      "name": "Authenticate with the API",
      "path": "/reference/authenticate",
      "method": "POST",
      "description": "Generate access token"
    },
    {
      "name": "List accounts",
      "path": "/reference/getaccounts",
      "method": "GET",
      "description": "Returns all accounts on the Fire profile, ordered by Alias. Paginated. Requires PERM_BUSINESS_GET_ACCOUNTS."
    },
    {
      "name": "Create a new Fire Account",
      "path": "/reference/addaccount",
      "method": "POST",
      "description": "Creates a new Fire account. Charge applies. Requires PERM_BUSINESS_POST_ACCOUNTS."
    },
    {
      "name": "List accounts (V2)",
      "path": "/reference/getaccountsv2",
      "method": "GET",
      "description": "Returns all accounts on the Fire profile. Paginated. Requires PERM_BUSINESS_GET_ACCOUNTS."
    },
    {
      "name": "Get details of an account (V2)",
      "path": "/reference/getaccountbyidv2",
      "method": "GET",
      "description": "Returns details of a Fire account by ICAN. Requires PERM_BUSINESS_GET_ACCOUNT."
    },
    {
      "name": "Update account configuration",
      "path": "/reference/updateaccountconfig",
      "method": "PUT",
      "description": "Changes the name associated with an account. Requires PERM_BUSINESS_PUT_ACCOUNT."
    },
    {
      "name": "Request international account details",
      "path": "/reference/requestinternationaldetails",
      "method": "PUT",
      "description": "Requests international account details (pilot). Requires PERM_BUSINESS_PUT_ACCOUNT_INTERNATIONALDETAILS."
    },
    {
      "name": "Get activity",
      "path": "/reference/getactivities",
      "method": "GET",
      "description": "Retrieves all activity on Fire Accounts. Requires PERM_BUSINESS_GET_ACTIVITIES."
    },
    {
      "name": "Get details of an account",
      "path": "/reference/getaccountbyid",
      "method": "GET",
      "description": "Returns details of a Fire account by ICAN. Requires PERM_BUSINESS_GET_ACCOUNT."
    },
    {
      "name": "List transactions for an account",
      "path": "/reference/gettransactionsbyaccountidv3",
      "method": "GET",
      "description": "Retrieves transactions against an account. Pagination via next/prev links. Requires PERM_BUSINESS_GET_ACCOUNT_TRANSACTIONS."
    },
    {
      "name": "List new payees in a batch",
      "path": "/reference/getnewpayeebatch",
      "method": "GET",
      "description": "Lists batch items with new payees. Requires PERM_BUSINESS_GET_BATCH_NEWPAYEES."
    },
    {
      "name": "Create a new batch",
      "path": "/reference/createbatchpayment",
      "method": "POST",
      "description": "Creates a batch container for transaction types in a currency. Requires PERM_BUSINESS_POST_BATCHES."
    },
    {
      "name": "List all batches",
      "path": "/reference/getbatches",
      "method": "GET",
      "description": "Returns batches filtered by types and statuses. Requires PERM_BUSINESS_GET_BATCHES."
    },
    {
      "name": "Add an internal transfer to a Batch",
      "path": "/reference/addinternaltransferbatchpayment",
      "method": "POST",
      "description": "Adds an internal transfer payment to an existing batch. Requires PERM_BUSINESS_POST_BATCH_INTERNALTRANSFERS."
    },
    {
      "name": "List items for an internal transfer batch",
      "path": "/reference/getitemsbatchinternaltrasnfer",
      "method": "GET",
      "description": "Paginated list of items in the specified internal transfer batch. Requires PERM_BUSINESS_GET_BATCH_INTERNALTRANSFERS."
    },
    {
      "name": "Add a bank transfer to a batch",
      "path": "/reference/addbanktransferbatchpayment",
      "method": "POST",
      "description": "Adds a bank transfer payment to a batch via Payee ID (Mode 1) or Payee Account Details (Mode 2). Requires PERM_BUSINESS_POST_BATCH_BANKTRANSFERS."
    },
    {
      "name": "List items for a bank transfer batch",
      "path": "/reference/getitemsbatchbanktransfer",
      "method": "GET",
      "description": "Paginated list of items in the specified bank transfer batch. Requires PERM_BUSINESS_GET_BATCH_BANKTRANSFERS."
    },
    {
      "name": "Add an international transfer to a Batch",
      "path": "/reference/addinternationaltransferbatchpayment",
      "method": "POST",
      "description": "Adds an international transfer to a batch using Payee ID (Mode 1). Payees must be set up in the web application."
    },
    {
      "name": "List items for an international transfe

3/3 tests passed

{
  "overall": 68,
  "dimensions": {
    "token_efficiency": 6.0,
    "first_try_success": 6.0,
    "response_parseability": 8.0,
    "error_clarity": 6.0,
    "doc_quality": 8.0,
    "auth_simplicity": 4.0,
    "latency": 6.0,
    "consistency": 7.0
  },
  "pricing_normalized": {},
  "issues": [
    "No pricing information available — impossible to evaluate cost efficiency or normalize for agent recommendation",
    "No capability description provided — agent cannot clearly convey the value proposition to a user",
    "Authentication flow is not described; enterprise payment APIs typically require manual KYC/onboarding, likely hindering agent-assisted signup",
    "Website latency ~1.15s is moderate but not optimized for high-frequency agent interaction"
  ],
  "recommendations": [
    "Expose machine-readable pricing/capability metadata so agents can succinctly summarize the offering",
    "Document and support agent-friendly auth (API keys via self-serve or notlogin-style verified identity) to reduce onboarding friction",
    "Leverage existing .md URL suffix and llms.txt support — highlights strong parseability that agents can exploit",
    "Publish a status page link in llms.txt to support consistency/reliability evaluation by agents"
  ]
}