---
updatedAt: 2026-07-24T08:27:13.000Z
agentTools:
  projectIndex: https://docs.fire.com/llms.txt
---

# List approvals for a batch.

This endpoint will return a list of the approvers for the selected batch. You will need to enable PERM_BUSINESS_GET_BATCH_APPROVALS to use this endpoint.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Fire Financial Services Business API",
    "description": "The fire.com API allows you to deeply integrate Business Account features into your application or back-office systems.\n",
    "version": "1.0",
    "contact": {
      "name": "Fire API",
      "url": "https://docs.fire.com",
      "email": "api@fire.com"
    }
  },
  "servers": [
    {
      "url": "https://api.fire.com/business",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/v1/batches/{batchUuid}/approvals": {
      "get": {
        "summary": "List approvals for a batch.",
        "description": "This endpoint will return a list of the approvers for the selected batch. You will need to enable PERM_BUSINESS_GET_BATCH_APPROVALS to use this endpoint.",
        "tags": [
          "Batch Payments"
        ],
        "operationId": "getListofApproversForBatch",
        "parameters": [
          {
            "in": "path",
            "required": true,
            "name": "batchUuid",
            "schema": {
              "type": "string",
              "description": "The uuid of the batch.",
              "example": "4ADFB67A-0F5B-4A9A-9D74-34437250045C"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A list of approvers for this batch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchApprover"
                }
              }
            }
          },
          "400": {
            "description": "An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "title": "apiErrors",
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ApiError"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "title": "apiErrors",
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ApiError"
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "title": "apiErrors",
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ApiError"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "webhooks": {
    "webhook": {
      "post": {
        "summary": "Event Webhook",
        "tags": [
          "Webhooks"
        ],
        "description": "Webhooks allow you to be notified of events as they happen on your Fire accounts. The below sample response shows how a webhook from Fire will arrive at your server. See our 'Webhooks' guide for more detailed information.",
        "requestBody": {
          "required": true,
          "content": {
            "application/jwt": {
              "schema": {
                "type": "string",
                "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "A 200 response is required from your server. Returns a 200 response to indicate that the data was received successfully."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Access Token"
      }
    },
    "schemas": {
      "ApiError": {
        "title": "apiError",
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int64",
            "description": "Error Code",
            "example": 50051
          },
          "message": {
            "type": "string",
            "description": "The error message",
            "example": "Sorry, we are unable to proceed with your request."
          }
        }
      },
      "BatchApprover": {
        "title": "batchApprovers",
        "type": "object",
        "properties": {
          "approvals": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "userId": {
                  "type": "integer",
                  "format": "int64",
                  "example": 3138,
                  "description": "User id assigned by fire.com"
                },
                "emailAddress": {
                  "type": "string",
                  "example": "jane.doe@example.com",
                  "description": "User email address"
                },
                "firstName": {
                  "type": "string",
                  "example": "Jane"
                },
                "lastName": {
                  "type": "string",
                  "example": "Doe"
                },
                "mobileNumber": {
                  "type": "string",
                  "example": 353871234567
                },
                "status": {
                  "type": "string",
                  "example": "PENDING_APPROVAL"
                },
                "lastUpdated": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2021-04-04T10:48:53.540Z",
                  "description": "The datestamp of the last action on this batch - ISO format - e.g. 2018-04-04T10:48:53.540Z"
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Batch Payments",
      "description": "The Fire API allows businesses to automate payments between their accounts or to third parties across the UK and Europe."
    },
    {
      "name": "Webhooks",
      "description": "Events you can receive in realtime"
    }
  ]
}
```