# List approvals

Lists all submitted time entry and expense item approvals for the organization.

A more typical scenario is to include approvals when getting time entries or expense items by specifying fields=approvals as a query parameter on the respective endpoints.

Endpoint: GET /approvals
Version: v1
Security: AuthToken

## Query parameters:

  - `per_page` (integer)
    The maximum number of items to show per response page.
    Example: 100

  - `page` (integer)
    The response page to return.
    Example: 2

  - `fields` (string)
    If set to approvables, includes the full detail of the approved TimeEntry or ExpenseItem in the response.
    Enum: "approvables"

## Response 200 fields (application/json):

  - `paging` (object)

  - `paging.per_page` (integer)
    The maximum number of items to show per response page.
    Example: 100

  - `paging.page` (integer)
    The current response page number.
    Example: 1

  - `paging.previous` (string,null)
    If you're on the first page, this value is null; otherwise the value is the path and query parameters to get the previous page of items.
    Example: "/api/v1/users?per_page=1000&page=1"

  - `paging.self` (string)
    The path and query parameters to get the current page of items.
    Example: "/api/v1/users?per_page=1000&page=2"

  - `paging.next` (string,null)
    If there are more items, this value is the path and query parameters to get the next page of items; otherwise, it's null.
    Example: "/api/v1/users?per_page=1000&page=3"

  - `paging.count` (integer,null)
    The total number of items in all the pages.

  - `data` (array)

  - `data.id` (integer)
    Unique identifier for the approval record.
    Example: 890

  - `data.status` (string)
    The current status of the approval.
    Enum: "pending", "approved", "rejected"

  - `data.approvable_id` (integer)
    The ID of the record being approved (TimeEntry or ExpenseItem).
    Example: 123

  - `data.approvable_type` (string)
    The type of record being approved.
    Enum: "TimeEntry", "ExpenseItem"

  - `data.submitted_by` (integer)
    The ID of the user who submitted the record.
    Example: 8

  - `data.submitted_at` (string)
    The timestamp when the record was submitted for approval.
    Example: "2016-10-13T20:16:40Z"

  - `data.approved_by` (integer,null)
    The ID of the user who approved the record, or null if not yet approved.

  - `data.approved_at` (string,null)
    The timestamp when the record was approved, or null if not yet approved.

  - `data.created_at` (string)

  - `data.updated_at` (string)