> Documentation index: [Saleor](/llms.txt) · [This section](/api-reference/orders/llms.txt)
> Source: https://docs.saleor.io/api-reference/orders/objects/invoice

# Invoice Object

Represents an Invoice.

```graphql
type Invoice implements ObjectWithMetadata, Job, Node {
  privateMetadata: [MetadataItem!]!
  privateMetafield(
    key: String!
  ): String
  privateMetafields(
    keys: [String!]
  ): Metadata
  metadata: [MetadataItem!]!
  metafield(
    key: String!
  ): String
  metafields(
    keys: [String!]
  ): Metadata
  status: JobStatusEnum!
  createdAt: DateTime!
  updatedAt: DateTime!
  message: String
  id: ID!
  number: String
  externalUrl: String @deprecated
  url: String
  order: Order
}
```

<a id="fields"></a>

### Fields

<a id="private-metadata"></a>

#### [`privateMetadata`](#private-metadata) ● [`[MetadataItem!]!`](/api-reference/miscellaneous/objects/metadata-item.md)

List of private metadata items. Requires staff permissions to access.

<a id="private-metafield"></a>

#### [`privateMetafield`](#private-metafield) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

A single key from private metadata. Requires staff permissions to access.

Tip: Use GraphQL aliases to fetch multiple keys.

<a id="invoice-private-metafield-key"></a>

##### [`key`](#invoice-private-metafield-key) ● [`String!`](/api-reference/miscellaneous/scalars/string.md)

<a id="private-metafields"></a>

#### [`privateMetafields`](#private-metafields) ● [`Metadata`](/api-reference/miscellaneous/scalars/metadata.md)

Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything.

<a id="invoice-private-metafields-keys"></a>

##### [`keys`](#invoice-private-metafields-keys) ● [`[String!]`](/api-reference/miscellaneous/scalars/string.md)

<a id="metadata"></a>

#### [`metadata`](#metadata) ● [`[MetadataItem!]!`](/api-reference/miscellaneous/objects/metadata-item.md)

List of public metadata items. Can be accessed without permissions.

<a id="metafield"></a>

#### [`metafield`](#metafield) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

A single key from public metadata.

Tip: Use GraphQL aliases to fetch multiple keys.

<a id="invoice-metafield-key"></a>

##### [`key`](#invoice-metafield-key) ● [`String!`](/api-reference/miscellaneous/scalars/string.md)

<a id="metafields"></a>

#### [`metafields`](#metafields) ● [`Metadata`](/api-reference/miscellaneous/scalars/metadata.md)

Public metadata. Use `keys` to control which fields you want to include. The default is to include everything.

<a id="invoice-metafields-keys"></a>

##### [`keys`](#invoice-metafields-keys) ● [`[String!]`](/api-reference/miscellaneous/scalars/string.md)

<a id="status"></a>

#### [`status`](#status) ● [`JobStatusEnum!`](/api-reference/miscellaneous/enums/job-status-enum.md)

Job status.

<a id="created-at"></a>

#### [`createdAt`](#created-at) ● [`DateTime!`](/api-reference/miscellaneous/scalars/date-time.md)

Date and time at which invoice was created.

<a id="updated-at"></a>

#### [`updatedAt`](#updated-at) ● [`DateTime!`](/api-reference/miscellaneous/scalars/date-time.md)

Date and time at which invoice was updated.

<a id="message"></a>

#### [`message`](#message) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

Message associated with an invoice.

<a id="id"></a>

#### [`id`](#id) ● [`ID!`](/api-reference/miscellaneous/scalars/id.md)

The ID of the object.

<a id="number"></a>

#### [`number`](#number) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

Invoice number.

<a id="url"></a>

#### [`url`](#url) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

URL to view/download an invoice.

<a id="order"></a>

#### [`order`](#order) ● [`Order`](/api-reference/orders/objects/order.md)

Order related to the invoice.

Show deprecatedHide deprecated

<a id="external-url"></a>

#### [`externalUrl`](#external-url) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

DEPRECATED

Use `url` field.

URL to view an invoice.

<a id="interfaces"></a>

### Interfaces

<a id="objectwithmetadata"></a>

#### [`ObjectWithMetadata`](/api-reference/miscellaneous/interfaces/object-with-metadata.md)

<a id="job"></a>

#### [`Job`](/api-reference/miscellaneous/interfaces/job.md)

<a id="node"></a>

#### [`Node`](/api-reference/miscellaneous/interfaces/node.md)

An object with an ID

<a id="member-of"></a>

### Member Of

[`InvoiceCreate`](/api-reference/orders/objects/invoice-create.md) object  ● [`InvoiceDelete`](/api-reference/orders/objects/invoice-delete.md) object  ● [`InvoiceDeleted`](/api-reference/orders/objects/invoice-deleted.md) object  ● [`InvoiceRequest`](/api-reference/orders/objects/invoice-request.md) object  ● [`InvoiceRequestDelete`](/api-reference/orders/objects/invoice-request-delete.md) object  ● [`InvoiceRequested`](/api-reference/orders/objects/invoice-requested.md) object  ● [`InvoiceSendNotification`](/api-reference/orders/objects/invoice-send-notification.md) object  ● [`InvoiceSent`](/api-reference/orders/objects/invoice-sent.md) object  ● [`InvoiceUpdate`](/api-reference/orders/objects/invoice-update.md) object  ● [`Order`](/api-reference/orders/objects/order.md) object