> ## Documentation Index
> Fetch the complete documentation index at: https://docs.restaurant365.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /public/accounting/v1/accounts-payable/payments

> Retrieves payments with optional filtering and pagination

## OpenAPI

````json GET /public/accounting/v1/accounts-payable/payments
{
  "openapi": "3.0.1",
  "info": {
    "title": "R365.PublicApi",
    "contact": {
      "name": "R365 Services Team",
      "email": "r365@restaurant365.com"
    },
    "version": "1.0"
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "paths": {
    "/public/accounting/v1/accounts-payable/payments": {
      "get": {
        "tags": [
          "accounting"
        ],
        "description": "Retrieves payments with optional filtering and pagination",
        "parameters": [
          {
            "name": "ModifiedOnStart",
            "in": "query",
            "description": "Modified date start (inclusive)",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "ModifiedOnEnd",
            "in": "query",
            "description": "Modified date end (inclusive)",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "DateStart",
            "in": "query",
            "description": "Date start (inclusive)",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "DateEnd",
            "in": "query",
            "description": "Date end (inclusive)",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "Status",
            "in": "query",
            "description": "Approval status (Approved, Unapproved)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "PaymentNumbers",
            "in": "query",
            "description": "Payment numbers (comma-separated)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "PaymentIds",
            "in": "query",
            "description": "Payment IDs (comma-separated GUIDs)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "Number of results per page. Default: 250, Max: 250",
            "schema": {
              "maximum": 250,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 250
            }
          },
          {
            "name": "ContinuationToken",
            "in": "query",
            "description": "Continuation token for pagination. Use the nextLink from a previous response to get the next page of results",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Payment query results.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.QueryPaymentsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/R365.Accounting.Public.Models.R365Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "R365.Accounting.Public.Contracts.Payments.Models.QueryPaymentsResponse": {
        "type": "object",
        "properties": {
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.Payment"
            },
            "description": "The collection of payments for the current page.",
            "nullable": true
          },
          "nextLink": {
            "type": "string",
            "description": "The URL to retrieve the next page of results, or null if this is the last page.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Paginated response containing queried payments."
      },
      "R365.Accounting.Public.Models.R365Error": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "nullable": true
          },
          "innerError": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Models.R365Error"
          }
        }
      },
      "R365.Accounting.Public.Contracts.Payments.Models.Payment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier (GUID) of the payment.",
            "format": "uuid"
          },
          "number": {
            "type": "string",
            "description": "Payment number.",
            "nullable": true
          },
          "location": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.LocationReference"
          },
          "vendor": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.VendorReference"
          },
          "date": {
            "type": "string",
            "description": "Date the payment was issued.",
            "format": "date",
            "nullable": true
          },
          "amount": {
            "type": "number",
            "description": "Total amount of the payment.",
            "format": "double"
          },
          "comment": {
            "type": "string",
            "description": "Free-text comment or memo on the payment.",
            "nullable": true
          },
          "status": {
            "type": "string",
            "description": "Approval status of the payment. Values are \"Approved\", \"Unapproved\".",
            "nullable": true
          },
          "checkingAccount": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.GlAccountReference"
          },
          "appliedInvoices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.AppliedInvoiceReference"
            },
            "description": "Invoices applied to this payment, if any.",
            "nullable": true
          },
          "distributions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.DistributionLine"
            },
            "description": "GL distribution lines for this payment, included when IncludeDistributions is true in the request.",
            "nullable": true
          },
          "createdOn": {
            "type": "string",
            "description": "Timestamp when the payment was created.",
            "format": "date-time",
            "nullable": true
          },
          "createdBy": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.UserReference",
            "description": "User who created the payment."
          },
          "modifiedOn": {
            "type": "string",
            "description": "Timestamp of the most recent modification.",
            "format": "date-time",
            "nullable": true
          },
          "modifiedBy": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.UserReference",
            "description": "User who last modified the payment."
          },
          "approvedOn": {
            "type": "string",
            "description": "Timestamp when the payment was approved.",
            "format": "date-time",
            "nullable": true
          },
          "approvedBy": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.UserReference",
            "description": "User who approved the payment."
          },
          "attachments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.TransactionAttachment"
            },
            "description": "Files attached to this payment.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Payment model for the query payments public API response."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.LocationReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier (GUID) of the location.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "Display name of the location.",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "Location number.",
            "nullable": true
          },
          "legalEntity": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.LegalEntityReference"
          }
        },
        "additionalProperties": false,
        "description": "Location reference with optional legal entity."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.VendorReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier (GUID) of the vendor.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "Vendor display name (check name).",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "Vendor account number.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Vendor reference with id, name (CheckName), and number (AccountNumber)."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.GlAccountReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier (GUID) of the GL account.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "Display name of the GL account.",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "GL account number.",
            "nullable": true
          },
          "glType": {
            "type": "string",
            "description": "GL type name for this account.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "GL Account reference."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.AppliedInvoiceReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier (GUID) of the invoice.",
            "format": "uuid"
          },
          "invoiceNumber": {
            "type": "string",
            "description": "Invoice number.",
            "nullable": true
          },
          "appliedAmount": {
            "type": "number",
            "description": "Amount applied from this invoice toward the payment.",
            "format": "double"
          },
          "invoiceTotal": {
            "type": "number",
            "description": "Total amount of the invoice.",
            "format": "double"
          }
        },
        "additionalProperties": false,
        "description": "Reference to an invoice applied to a payment."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.DistributionLine": {
        "type": "object",
        "properties": {
          "glAccount": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.GlAccountReference"
          },
          "debit": {
            "type": "number",
            "description": "Debit amount on this distribution line. Zero when the line is a credit.",
            "format": "double"
          },
          "credit": {
            "type": "number",
            "description": "Credit amount on this distribution line. Zero when the line is a debit.",
            "format": "double"
          },
          "comment": {
            "type": "string",
            "description": "Comment on this distribution line.",
            "nullable": true
          },
          "location": {
            "$ref": "#/components/schemas/R365.Accounting.Public.Contracts.Payments.Models.LocationReference"
          }
        },
        "additionalProperties": false,
        "description": "A single GL distribution line for a posted transaction."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.UserReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier (GUID) of the entity.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "Display name of the entity.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "User reference."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.TransactionAttachment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Numeric identifier of the attachment.",
            "format": "int32"
          },
          "storageFileName": {
            "type": "string",
            "description": "Internal storage key or path for the file.",
            "nullable": true
          },
          "filename": {
            "type": "string",
            "description": "Original file name as uploaded.",
            "nullable": true
          },
          "linkType": {
            "type": "string",
            "description": "Link type indicating how the attachment is associated with the transaction.",
            "nullable": true
          },
          "publicUrl": {
            "type": "string",
            "description": "Public URL to download the full attachment.",
            "nullable": true
          },
          "publicThumbnailUrl": {
            "type": "string",
            "description": "Public URL for a thumbnail preview of the attachment, if available.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "File attachment linked to an AP transaction."
      },
      "R365.Accounting.Public.Contracts.Payments.Models.LegalEntityReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier (GUID) of the legal entity.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "Display name of the legal entity.",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "Legal entity number.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Legal entity reference."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "Put **_ONLY_** your JWT Bearer token on textbox below!",
        "scheme": "Bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
````