# List bill rates

Lists the accessible bill rates.

Endpoint: GET /bill_rates
Version: v1
Security: AuthToken

## Header parameters:

  - `Content-Type` (string, required)
    Enum: "application/json"

  - `Accept` (string, required)
    Enum: "application/json"

## 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

## Response 200 fields (application/json):

  - `paging` (object, required)

  - `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, required)

  - `data.id` (integer)
    The unique identifier for the bill rate.
    Example: 991618

  - `data.discipline_id` (integer,null)
    If set to a discipline ID, this bill rate is a discipline-specific bill rate.

This can only be set via the Resource Management application UI.

  - `data.role_id` (integer,null)
    If set to a role ID, this bill rate is a role-specific bill rate.

This can only be set via the Resource Management application UI.
    Example: 30

  - `data.assignable_id` (integer,null)
    The ID of the project or phase to which the the bill rate applies.

> Note: Account-specific bill rates don't have an assignable_id value.
    Example: 1234

  - `data.user_id` (integer,null)
    The ID of a user to which the the bill rate applies.
    Example: 1001

  - `data.rate` (number)
    The cost value.
    Example: 100

  - `data.starts_at` (string,null)
    This user bill rate date indicates the rate's effective start date.

Note: This parameter is only applicable to user bill rates.
    Example: "2025-09-17"

  - `data.ends_at` (string,null)
    This user bill rate date indicates the rate's effective end date.

Note: This parameter is only applicable to user bill rates.
    Example: "2025-12-17"

  - `data.created_at` (string)
    The bill rate's creation timestamp.
    Example: "2025-01-22T06:00:30Z"

  - `data.updated_at` (string)
    The timestamp of the bill rate's last update.
    Example: "2025-01-22T06:13:40Z"