# List received (supplier) invoices, newest invoice_date first (https://docs.getbeel.com/en/api/reference/received-invoices/listReceivedInvoices)

## GET /received-invoices

```json

{
  "operationId": "listReceivedInvoices",
  "summary": "List received (supplier) invoices, newest invoice_date first",
  "description": "Invoices received through SDI (source sdi) and collected from email, forwarding or uploads. With a test key: only the invoices received in the sandbox (POST /sandbox/inbound-invoices).",
  "tags": [
    "Received invoices"
  ],
  "x-required-scope": "received_invoices:read",
  "parameters": [
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Page size, 1–100",
      "schema": {
        "default": 20,
        "type": "integer",
        "minimum": 1,
        "maximum": 100
      }
    },
    {
      "name": "cursor",
      "in": "query",
      "required": false,
      "description": "`next_cursor` of the previous page",
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    {
      "name": "search",
      "in": "query",
      "required": false,
      "description": "Supplier name or invoice number, case-insensitive",
      "schema": {
        "examples": [
          "Enel"
        ],
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    {
      "name": "source",
      "in": "query",
      "required": false,
      "description": "sdi (received through SDI, see GET /sdi-receiving), email (found by a mailbox scan), forwarded (sent to the forwarding address), manual (uploaded), bank_transaction (created from a bank movement)",
      "schema": {
        "type": "string",
        "enum": [
          "email",
          "forwarded",
          "manual",
          "bank_transaction",
          "sdi"
        ]
      }
    },
    {
      "name": "status",
      "in": "query",
      "required": false,
      "description": "pending_review: extracted, waiting for a person; verified: approved; rejected; exported; missing_document: a payment without its document yet; processing: being extracted",
      "schema": {
        "type": "string",
        "enum": [
          "processing",
          "pending_review",
          "verified",
          "rejected",
          "exported",
          "missing_document"
        ]
      }
    },
    {
      "name": "date_from",
      "in": "query",
      "required": false,
      "description": "invoice_date on or after (YYYY-MM-DD)",
      "schema": {
        "type": "string",
        "format": "date",
        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
      }
    },
    {
      "name": "date_to",
      "in": "query",
      "required": false,
      "description": "invoice_date on or before (YYYY-MM-DD)",
      "schema": {
        "type": "string",
        "format": "date",
        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
      }
    },
    {
      "name": "Getbeel-Company",
      "in": "header",
      "required": false,
      "description": "Act on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.",
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ReceivedInvoiceList"
          }
        }
      }
    },
    "400": {
      "description": "Invalid request",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "401": {
      "description": "Missing, invalid, revoked or expired API key",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "403": {
      "description": "The key lacks the 'received_invoices:read' scope",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "404": {
      "description": "company_not_found (Getbeel-Company)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "429": {
      "description": "Rate limit exceeded; see Retry-After",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "500": {
      "description": "Server error; quote X-Request-Id",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}

```

Full OpenAPI document: https://docs.getbeel.com/openapi.json