# `bird numbers orders list` ## Usage ```bash bird numbers orders list [flags] ``` ## Description Pages the workspace's purchase attempts, newest first, filtered by status. An order outlives its attempt, so a failure stays readable with the reason it carried. Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after. ## Examples ```bash bird numbers orders list bird numbers orders list | jq -r '.data[].id' bird numbers orders list --limit 50 --starting-after ``` ## Options #### Pagination | Name | Description | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `--ending-before` | Cursor from the prev_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. | | `--limit ` | Maximum number of items to return per page. | | `--starting-after` | Cursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order. | #### Filters | Name | Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--response-schema` | Print the fields this command returns, then exit | | `--status` | Return only orders with status charging, ordering, pending, completed, or failed. Known values: charging, ordering, pending, completed, failed (others may exist). | ## Related | Name | Description | | ------------------------------------------------------------------------- | --------------------- | | [`bird numbers orders create`](/docs/cli/reference/numbers-orders-create) | Create a number order | | [`bird numbers orders get`](/docs/cli/reference/numbers-orders-get) | Get a number order |