# Get Invoices

**GET /api/billing/invoice**

Retrieves all generated invoices that match the yardId, carrierId, and periodCode attributes provided.


## Servers
- GCP Development: https://api-dev.gatego.io (GCP Development)
- Production: https://api.gatego.io (Production)



## Parameters


### Query parameters
- **carrierId** (integer(int64))

- **periodCode** (string)
  Period for which the invoice will be generated. The invoices can be retrieved by period. Currently, only monthly periods in the format `YYYYMM` are supported, but in the future we might support others such as weekly periods in the form of '2025W12'
- **yardId** (integer(int64))



## Responses
### 200
OK

#### Body: application/json (array[object])
- **id** (integer(int64))
  Invoice ID
- **yard_id** (integer(int64))
  Yard ID
- **carrier_id** (integer(int64))
  Carrier ID
- **invoice_number** (string)
  Invoice number
- **invoice_date** ()

- **period_code** (string)
  Code representing the billing period
- **period_start** ()

- **period_end** ()

- **truck_config** (object)

- **trucks_section** (object)

- **trucks_missing_checkin_section** (object)

- **trailer_config** (object)

- **trailers_section** (object)

- **trailers_missing_checkin_section** (object)

- **adjustments_section** (object)

- **total_amount** (number)
  The total amount billed in this invoice
- **currency** (string)
  The currency used in this invoice

### 401
Not Authorized

### 403
Not Allowed


[Powered by Bump.sh](https://bump.sh)