---
title: "Retrieve a paginated list of submission policies"
method: GET
path: "/v1/submission-policies"
tags: ["Submission Policies"]
---

# Retrieve a paginated list of submission policies

`GET /v1/submission-policies`

## Query parameters

- `created_at__gte` string, date-time
- `created_at__lte` string, date-time, nullable
- `order_by` 'created_at' | '-created_at'
- `page` integer
- `page_size` integer

## Response `200`

A paginated list of submission policies

- CountablePagedResponseSubmissionPolicySchema
  - `items` SubmissionPolicySchema[], required — The list of items on the current page.
    - `id` string, uuid, required — The unique identifier of the submission policy.
    - `name` string, required — The name of the submission policy.
    - `type` string, required — The type of the submission policy.
    - `description` string, nullable, required — The description of the submission policy.
    - `auto_pause` AutoPauseSchema, required
      - `enabled` boolean, required — Whether the card is automatically paused when policy violations occur.
      - `after_num_violations` integer, nullable, required — The number of violations after which the card is automatically paused.
    - `rules` RulesSchema, required
      - `description` RuleFieldSchema, required
        - `required` boolean, required — Whether this field is required for submissions.
        - `over_amount` integer, required — The minimum amount in cents above which this field is required. Only applicable when required is true.
      - `receipt` RuleFieldSchema, required
        - `required` boolean, required — Whether this field is required for submissions.
        - `over_amount` integer, required — The minimum amount in cents above which this field is required. Only applicable when required is true.
      - `vendor` AllowedValuesRuleSchemaAccountingVendor, required
        - `required` boolean, required — Whether this field is required for submissions.
        - `over_amount` integer, required — The minimum amount in cents above which this field is required. Only applicable when required is true.
        - `only_allowed_values` boolean, required — Whether only the specified allowed values are permitted for this field.
        - `allowed_values` NameReferenceSchemaAccountingVendor[], required — The list of allowed values for this field when restricted.
          - `id` string, uuid, required — Unique identifier for the referenced entity.
          - `name` string, required — Name of the referenced entity.
      - `gl_code` AllowedValuesRuleSchemaGLCode, required
        - `required` boolean, required — Whether this field is required for submissions.
        - `over_amount` integer, required — The minimum amount in cents above which this field is required. Only applicable when required is true.
        - `only_allowed_values` boolean, required — Whether only the specified allowed values are permitted for this field.
        - `allowed_values` NameReferenceSchemaGLCode[], required — The list of allowed values for this field when restricted.
          - `id` string, uuid, required — Unique identifier for the referenced entity.
          - `name` string, required — Name of the referenced entity.
      - `tax_code` AllowedValuesRuleSchemaTaxCode, required
        - `required` boolean, required — Whether this field is required for submissions.
        - `over_amount` integer, required — The minimum amount in cents above which this field is required. Only applicable when required is true.
        - `only_allowed_values` boolean, required — Whether only the specified allowed values are permitted for this field.
        - `allowed_values` NameReferenceSchemaTaxCode[], required — The list of allowed values for this field when restricted.
          - `id` string, uuid, required — Unique identifier for the referenced entity.
          - `name` string, required — Name of the referenced entity.
      - `tag` AllowedValuesRuleSchemaGenericTag, required
        - `required` boolean, required — Whether this field is required for submissions.
        - `over_amount` integer, required — The minimum amount in cents above which this field is required. Only applicable when required is true.
        - `only_allowed_values` boolean, required — Whether only the specified allowed values are permitted for this field.
        - `allowed_values` NameReferenceSchemaGenericTag[], required — The list of allowed values for this field when restricted.
          - `id` string, uuid, required — Unique identifier for the referenced entity.
          - `name` string, required — Name of the referenced entity.
      - `custom_fields` CustomFieldRuleSchema[], required — Rules for custom field requirements.
        - `required` boolean, required — Whether this field is required for submissions.
        - `over_amount` integer, required — The minimum amount in cents above which this field is required. Only applicable when required is true.
        - `only_allowed_values` boolean, required — Whether only the specified allowed values are permitted for this field.
        - `allowed_values` NameReferenceSchemaCustomFieldsPolicyRule[], required — The list of allowed values for this field when restricted.
          - `id` string, uuid, required — Unique identifier for the referenced entity.
          - `name` string, required — Name of the referenced entity.
        - `custom_field` NameReferenceSchemaCustomFieldsPolicyRule, required
          - `id` string, uuid, required — Unique identifier for the referenced entity.
          - `name` string, required — Name of the referenced entity.
  - `page` integer, required — The current page number.
  - `page_size` integer, required — The number of items per page.
  - `created_at__lte` string, date-time, required — The most recent date for which results are included.
  - `created_at__gte` string, date-time, required — The least recent date for which results are included.
  - `ordered_by` 'created_at' | '-created_at', required
  - `pages` integer, required — The total number of pages available.
  - `count` integer, required — The total number of items available.

---

[API](https://skmtc.dev/floatfinancial/apis/float-public-api.md) · [All operations](https://skmtc.dev/floatfinancial/apis/float-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/floatfinancial/float-public-api/revisions/a3c42eb1b312/schema)
