# headerFooters.pageNumbers.get

> Read where a section shows page numbers, their alignment, the first-page choice, and the section's number style and start. Available on v2-backed sessions only; v1-backed sessions currently return `CAPABILITY_UNAVAILABLE`.



- Member path: `doc.headerFooters.pageNumbers.get(…)`
- Mutates document: no
- Idempotency: `idempotent`
- Supports tracked mode: no
- Supports dry run: no

## Expected result

Returns the header and footer placements that show a PAGE field (empty when none), first-page visibility, the number format, and the start number or null when numbering continues.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "SectionAddress": {
      "type": "object",
      "properties": {
        "kind": {
          "const": "section"
        },
        "sectionId": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "kind",
        "sectionId"
      ]
    }
  },
  "type": "object",
  "properties": {
    "section": {
      "$ref": "#/$defs/SectionAddress"
    }
  },
  "additionalProperties": false,
  "required": [
    "section"
  ]
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "SectionAddress": {
      "type": "object",
      "properties": {
        "kind": {
          "const": "section"
        },
        "sectionId": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "kind",
        "sectionId"
      ]
    }
  },
  "type": "object",
  "properties": {
    "section": {
      "$ref": "#/$defs/SectionAddress"
    },
    "placements": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "enum": [
              "header",
              "footer"
            ]
          },
          "alignment": {
            "oneOf": [
              {
                "enum": [
                  "left",
                  "center",
                  "right"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "parts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "const": "headerFooterPart"
                },
                "refId": {
                  "type": "string"
                }
              },
              "additionalProperties": false,
              "required": [
                "kind",
                "refId"
              ]
            }
          }
        },
        "additionalProperties": false,
        "required": [
          "kind",
          "alignment",
          "parts"
        ]
      }
    },
    "showOnFirstPage": {
      "type": "boolean"
    },
    "titlePage": {
      "type": "boolean"
    },
    "format": {
      "enum": [
        "decimal",
        "lowerLetter",
        "upperLetter",
        "lowerRoman",
        "upperRoman",
        "numberInDash",
        "hebrew1",
        "hebrew2"
      ]
    },
    "start": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "section",
    "placements",
    "showOnFirstPage",
    "titlePage",
    "format",
    "start"
  ]
}
```

## Pre-apply throws

- `TARGET_NOT_FOUND`
- `INVALID_TARGET`
- `INVALID_INPUT`
- `CAPABILITY_UNAVAILABLE`

## Non-applied receipt codes

- None