Invoice

Get all invoices on a workspace

Changed on
get/v1/workspaces/{workspaceId}/invoices

Request

  • Base URL: https://api.clockify.me/api
  • URL: https://api.clockify.me/api/v1/workspaces/{workspaceId}/invoices
  • Auth: one of:
    • API key in header x-api-key
    • API key in header x-addon-token

Path parameters

workspaceIdstring required

Represents a workspace identifier across the system.

Example:64a687e29ae1f428e7ebe303

Query parameters

pageinteger

Page number.

Example:1
page-sizeinteger

Page size.

Example:50
statuses'UNSENT' | 'SENT' | 'PAID' | 'PARTIALLY_PAID' | 'VOID' | 'OVERDUE'

If provided, you'll get a filtered result of invoices that matches the provided string in the user ID linked to the expense.

sort-column'ID' | 'CLIENT' | 'DUE_ON' | 'ISSUE_DATE' | 'AMOUNT' | 'BALANCE'

Valid column name as sorting criteria. Default: ID

sort-order'ASCENDING' | 'DESCENDING'

Sort order. Default: ASCENDING

Response

OK

totalinteger

Represents the total invoice count.

Example response

{
  "invoices": [
    {
      "amount": 100,
      "balance": 50,
      "clientId": "98h687e29ae1f428e7ebe707",
      "clientName": "Client X",
      "currency": "USD",
      "dueDate": "2020-06-01T08:00:00Z",
      "id": "78a687e29ae1f428e7ebe303",
      "issuedDate": "2020-01-01T08:00:00Z",
      "number": "202306121129",
      "paid": 50,
      "status": "PAID"
    }
  ],
  "total": 100
}

Changes

  • a5b636acbcd8Revision changes
    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value was added for the status