> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/navixy-graphql-api/products/billing/api-reference/submission.md).

# Submissions

Reference for the usage-metric and invoice-line-item submissions of your workspace: the myUsageMetricSubmissions and myInvoiceLineItemSubmissions queries, with their filter, order, and pagination type

The usage-metric and invoice-line-item submissions reported for your workspace, and the queries that list them.

## Queries

### myUsageMetricSubmissions

The usage-metric submissions reported for the caller's own workspace, newest first by default.

**The workspace is not an argument.** It is the one the caller's token names; a token carrying no workspace claim is refused.

```graphql
myUsageMetricSubmissions(
    filter: BillingUsageMetricSubmissionFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: BillingUsageMetricSubmissionOrder = { field: SUBMITTED_AT, direction: DESC }
  ): BillingUsageMetricSubmissionConnection!
```

**Arguments**

| Name      | Type                                 | Description                                                                                   |
| --------- | ------------------------------------ | --------------------------------------------------------------------------------------------- |
| `filter`  | `BillingUsageMetricSubmissionFilter` | Filtering options for the returned submissions.                                               |
| `first`   | `Int`                                | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md).     |
| `after`   | `String`                             | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md).  |
| `last`    | `Int`                                | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md).      |
| `before`  | `String`                             | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `BillingUsageMetricSubmissionOrder`  | The ordering options for the returned submissions.                                            |

**Input types:**

<details>

<summary>BillingUsageMetricSubmissionFilter</summary>

Filtering options for the caller's own usage-metric submissions. Fields combine with AND. No workspace field: the workspace is the one the token names.

| Field             | Type                                                                       | Description                                                                                                                               |
| ----------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `metricId`        | `ID`                                                                       | Filter by the metric the usage was reported against.                                                                                      |
| `productDomainId` | `ID`                                                                       | Filter by the product domain the usage belongs to.                                                                                        |
| `accounted`       | `Boolean`                                                                  | Filter by invoicing state: `false` = unaccounted (not yet rolled into an invoice), `true` = accounted (already invoiced), omitted = both. |
| `submittedAtFrom` | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or after this timestamp (inclusive).                                                         |
| `submittedAtTo`   | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or before this timestamp (inclusive).                                                        |

</details>

<details>

<summary>BillingUsageMetricSubmissionOrder</summary>

Ordering options for usage-metric submissions.

| Field       | Type                                                                                    | Description             |
| ----------- | --------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [BillingUsageMetricSubmissionOrderField](#billingusagemetricsubmissionorderfield)!      | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |

</details>

**Output types:**

<details>

<summary>BillingUsageMetricSubmissionConnection</summary>

A paginated list of BillingUsageMetricSubmission items.

**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)

| Field      | Type                                                                         | Description                                                |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[BillingUsageMetricSubmissionEdge](#billingusagemetricsubmissionedge)!]!   | A list of edges.                                           |
| `nodes`    | \[[BillingUsageMetricSubmission](#billingusagemetricsubmission)!]!           | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)!  | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter.              |

</details>

***

### myInvoiceLineItemSubmissions

The invoice-line-item submissions reported for the caller's own workspace, newest first by default.

**The workspace is not an argument.** It is the one the caller's token names; a token carrying no workspace claim is refused.

```graphql
myInvoiceLineItemSubmissions(
    filter: BillingInvoiceLineItemSubmissionFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: BillingInvoiceLineItemSubmissionOrder = { field: SUBMITTED_AT, direction: DESC }
  ): BillingInvoiceLineItemSubmissionConnection!
```

**Arguments**

| Name      | Type                                     | Description                                                                                   |
| --------- | ---------------------------------------- | --------------------------------------------------------------------------------------------- |
| `filter`  | `BillingInvoiceLineItemSubmissionFilter` | Filtering options for the returned submissions.                                               |
| `first`   | `Int`                                    | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md).     |
| `after`   | `String`                                 | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md).  |
| `last`    | `Int`                                    | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md).      |
| `before`  | `String`                                 | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `BillingInvoiceLineItemSubmissionOrder`  | The ordering options for the returned submissions.                                            |

**Input types:**

<details>

<summary>BillingInvoiceLineItemSubmissionFilter</summary>

Filtering options for the caller's own invoice-line-item submissions. Fields combine with AND. No workspace field: the workspace is the one the token names.

| Field             | Type                                                                       | Description                                                                                                                               |
| ----------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `productDomainId` | `ID`                                                                       | Filter by the product domain the line item belongs to.                                                                                    |
| `accounted`       | `Boolean`                                                                  | Filter by invoicing state: `false` = unaccounted (not yet rolled into an invoice), `true` = accounted (already invoiced), omitted = both. |
| `submittedAtFrom` | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or after this timestamp (inclusive).                                                         |
| `submittedAtTo`   | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or before this timestamp (inclusive).                                                        |

</details>

<details>

<summary>BillingInvoiceLineItemSubmissionOrder</summary>

Ordering options for invoice-line-item submissions.

| Field       | Type                                                                                       | Description             |
| ----------- | ------------------------------------------------------------------------------------------ | ----------------------- |
| `field`     | [BillingInvoiceLineItemSubmissionOrderField](#billinginvoicelineitemsubmissionorderfield)! | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)!    | The direction to order. |

</details>

**Output types:**

<details>

<summary>BillingInvoiceLineItemSubmissionConnection</summary>

A paginated list of BillingInvoiceLineItemSubmission items.

**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)

| Field      | Type                                                                               | Description                                                |
| ---------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[BillingInvoiceLineItemSubmissionEdge](#billinginvoicelineitemsubmissionedge)!]! | A list of edges.                                           |
| `nodes`    | \[[BillingInvoiceLineItemSubmission](#billinginvoicelineitemsubmission)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)!        | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo)       | The total count of items matching the filter.              |

</details>

***

## Objects

### BillingUsageMetricSubmission

Raw usage measurement submitted by a product service. Aggregated later into invoice line items.

**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node)

| Field               | Type                                                                                                          | Description                                                                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                | `ID!`                                                                                                         | A globally unique identifier. This ID is opaque and should not be parsed by clients.                                                         |
| `workspaceId`       | `ID!`                                                                                                         | The workspace the usage belongs to.                                                                                                          |
| `productDomain`     | [BillingProductDomain](/docs/navixy-graphql-api/products/billing/api-reference/plan.md#billingproductdomain)! | The product domain the usage was reported for.                                                                                               |
| `metric`            | [BillingMetric](/docs/navixy-graphql-api/products/billing/api-reference/plan.md#billingmetric)!               | The metric whose value is reported.                                                                                                          |
| `externalId`        | `String`                                                                                                      | External idempotency key (per producer scope).                                                                                               |
| `metricValue`       | `Float!`                                                                                                      | The metric value reported for the period.                                                                                                    |
| `periodStart`       | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)!                                   | Inclusive lower bound of the reporting window.                                                                                               |
| `periodEnd`         | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)!                                   | Exclusive upper bound of the reporting window.                                                                                               |
| `pricingDimensions` | [JSON](/docs/navixy-graphql-api/core-api-reference/common.md#json)                                            | Pricing dimension values used for VOLUME pricing tier resolution (key/value JSON).                                                           |
| `usageModifiers`    | [JSON](/docs/navixy-graphql-api/core-api-reference/common.md#json)                                            | Modifier values used for FLAT pricing multipliers (key/value JSON).                                                                          |
| `extraData`         | [JSON](/docs/navixy-graphql-api/core-api-reference/common.md#json)                                            | Arbitrary justification metadata; not regulated.                                                                                             |
| `invoiceId`         | `ID`                                                                                                          | Identifier of the invoice this submission has been claimed by; null while in the unbilled pool.                                              |
| `invoicedAt`        | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)                                    | When the submission was claimed onto an invoice; null iff invoiceId is null.                                                                 |
| `submittedAt`       | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)!                                   | When billing accepted the submission, from the server clock. A producer cannot supply its own.                                               |
| `submittedBy`       | `String!`                                                                                                     | The actor that sent the submission, or `system` when billing could not attribute it. Resolved server-side; a producer cannot supply its own. |

***

### BillingInvoiceLineItemSubmission

Pre-built invoice line item submitted externally (no aggregation, one row = one line).

**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node)

| Field           | Type                                                                                                          | Description                                                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | `ID!`                                                                                                         | A globally unique identifier. This ID is opaque and should not be parsed by clients.                                                         |
| `workspaceId`   | `ID!`                                                                                                         | The workspace the line item belongs to.                                                                                                      |
| `productDomain` | [BillingProductDomain](/docs/navixy-graphql-api/products/billing/api-reference/plan.md#billingproductdomain)! | The product domain the line item was reported for.                                                                                           |
| `externalId`    | `String`                                                                                                      | External idempotency key (per producer scope).                                                                                               |
| `description`   | `String!`                                                                                                     | Human-readable line description (will appear on the invoice).                                                                                |
| `quantity`      | `Float!`                                                                                                      | Quantity reported for the period.                                                                                                            |
| `unitPrice`     | [Money](/docs/navixy-graphql-api/core-api-reference/common.md#money)!                                         | Unit price for this line.                                                                                                                    |
| `amount`        | [Money](/docs/navixy-graphql-api/core-api-reference/common.md#money)                                          | Optional total amount; if null, the invoicer derives it from quantity \* unitPrice.                                                          |
| `periodStart`   | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)!                                   | Inclusive lower bound of the reporting window.                                                                                               |
| `periodEnd`     | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)!                                   | Exclusive upper bound of the reporting window.                                                                                               |
| `extraData`     | [JSON](/docs/navixy-graphql-api/core-api-reference/common.md#json)                                            | Arbitrary justification metadata; not regulated.                                                                                             |
| `invoiceId`     | `ID`                                                                                                          | Identifier of the invoice this submission has been claimed by; null while in the unbilled pool.                                              |
| `invoicedAt`    | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)                                    | When the submission was claimed onto an invoice; null iff invoiceId is null.                                                                 |
| `submittedAt`   | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime)!                                   | When billing accepted the submission, from the server clock. A producer cannot supply its own.                                               |
| `submittedBy`   | `String!`                                                                                                     | The actor that sent the submission, or `system` when billing could not attribute it. Resolved server-side; a producer cannot supply its own. |

***

## Inputs

### BillingUsageMetricSubmissionFilter

Filtering options for the caller's own usage-metric submissions. Fields combine with AND. No workspace field: the workspace is the one the token names.

| Field             | Type                                                                       | Description                                                                                                                               |
| ----------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `metricId`        | `ID`                                                                       | Filter by the metric the usage was reported against.                                                                                      |
| `productDomainId` | `ID`                                                                       | Filter by the product domain the usage belongs to.                                                                                        |
| `accounted`       | `Boolean`                                                                  | Filter by invoicing state: `false` = unaccounted (not yet rolled into an invoice), `true` = accounted (already invoiced), omitted = both. |
| `submittedAtFrom` | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or after this timestamp (inclusive).                                                         |
| `submittedAtTo`   | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or before this timestamp (inclusive).                                                        |

***

### BillingUsageMetricSubmissionOrder

Ordering options for usage-metric submissions.

| Field       | Type                                                                                    | Description             |
| ----------- | --------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [BillingUsageMetricSubmissionOrderField](#billingusagemetricsubmissionorderfield)!      | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |

***

### BillingInvoiceLineItemSubmissionFilter

Filtering options for the caller's own invoice-line-item submissions. Fields combine with AND. No workspace field: the workspace is the one the token names.

| Field             | Type                                                                       | Description                                                                                                                               |
| ----------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `productDomainId` | `ID`                                                                       | Filter by the product domain the line item belongs to.                                                                                    |
| `accounted`       | `Boolean`                                                                  | Filter by invoicing state: `false` = unaccounted (not yet rolled into an invoice), `true` = accounted (already invoiced), omitted = both. |
| `submittedAtFrom` | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or after this timestamp (inclusive).                                                         |
| `submittedAtTo`   | [DateTime](/docs/navixy-graphql-api/core-api-reference/common.md#datetime) | Return submissions whose `submittedAt` is at or before this timestamp (inclusive).                                                        |

***

### BillingInvoiceLineItemSubmissionOrder

Ordering options for invoice-line-item submissions.

| Field       | Type                                                                                       | Description             |
| ----------- | ------------------------------------------------------------------------------------------ | ----------------------- |
| `field`     | [BillingInvoiceLineItemSubmissionOrderField](#billinginvoicelineitemsubmissionorderfield)! | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)!    | The direction to order. |

***

## Enums

### BillingUsageMetricSubmissionOrderField

Fields available for ordering usage-metric submissions.

| Value          | Description                                    |
| -------------- | ---------------------------------------------- |
| `SUBMITTED_AT` | Order by when billing recorded the submission. |
| `PERIOD_START` | Order by the start of the usage period.        |
| `VALUE`        | Order by the reported metric value.            |
| `METRIC`       | Order by the code of the referenced metric.    |

***

### BillingInvoiceLineItemSubmissionOrderField

Fields available for ordering invoice-line-item submissions.

| Value          | Description                                    |
| -------------- | ---------------------------------------------- |
| `SUBMITTED_AT` | Order by when billing recorded the submission. |
| `PERIOD_START` | Order by the start of the billing period.      |

***

## Pagination types

### BillingUsageMetricSubmissionConnection

A paginated list of BillingUsageMetricSubmission items.

**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)

| Field      | Type                                                                         | Description                                                |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[BillingUsageMetricSubmissionEdge](#billingusagemetricsubmissionedge)!]!   | A list of edges.                                           |
| `nodes`    | \[[BillingUsageMetricSubmission](#billingusagemetricsubmission)!]!           | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)!  | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter.              |

***

### BillingUsageMetricSubmissionEdge

An edge in the BillingUsageMetricSubmission connection.

**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)

| Field    | Type                                                           | Description                                         |
| -------- | -------------------------------------------------------------- | --------------------------------------------------- |
| `cursor` | `String!`                                                      | An opaque cursor for this edge.                     |
| `node`   | [BillingUsageMetricSubmission](#billingusagemetricsubmission)! | The usage-metric submission at the end of the edge. |

***

### BillingInvoiceLineItemSubmissionConnection

A paginated list of BillingInvoiceLineItemSubmission items.

**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)

| Field      | Type                                                                               | Description                                                |
| ---------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[BillingInvoiceLineItemSubmissionEdge](#billinginvoicelineitemsubmissionedge)!]! | A list of edges.                                           |
| `nodes`    | \[[BillingInvoiceLineItemSubmission](#billinginvoicelineitemsubmission)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)!        | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo)       | The total count of items matching the filter.              |

***

### BillingInvoiceLineItemSubmissionEdge

An edge in the BillingInvoiceLineItemSubmission connection.

**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)

| Field    | Type                                                                   | Description                                              |
| -------- | ---------------------------------------------------------------------- | -------------------------------------------------------- |
| `cursor` | `String!`                                                              | An opaque cursor for this edge.                          |
| `node`   | [BillingInvoiceLineItemSubmission](#billinginvoicelineitemsubmission)! | The invoice-line-item submission at the end of the edge. |

***

## See also

* [Pagination](/docs/navixy-graphql-api/pagination.md)
* [Filtering and sorting](/docs/navixy-graphql-api/filtering-and-sorting.md)
* [Error handling](/docs/navixy-graphql-api/error-handling.md)
* [Optimistic locking](/docs/navixy-graphql-api/optimistic-locking.md)
* [Limits](/docs/navixy-graphql-api/limits.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/navixy-graphql-api/products/billing/api-reference/submission.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.