--- title: "List all Inquiries" method: GET path: "/inquiries" tags: ["inquiries"] --- # List all Inquiries `GET /inquiries` ## Request - Base URL: `https://api.withpersona.com/api/v1` - URL: `https://api.withpersona.com/api/v1/inquiries` - Auth: HTTP bearer Returns a list of your organization's inquiries. Note that this endpoint aggregates inquiries across all inquiry template(s). See [Pagination](https://docs.withpersona.com/pagination) for more details about handling the response. Results are returned in reverse chronological order, with the most recently created objects first. ## Query parameters - `page` InquiriesGetParametersPage - `after` string: Object ID for pagination cursor - `before` string: Object ID for pagination cursor - `size` number, double: Limit on the number of objects returned - `fields` object - `filter` InquiriesGetParametersFilter - `inquiry-id` string: Comma separated list of inquiry IDs (starting with `inq_`) to filter inquiries by - `account-id` string: Comma separated list of account IDs (starting with `act_`) to filter inquiries by - `note` string: Filter inquiries by note. Must be the only filter. - `reference-id` string: Filter inquiries by reference ID - `inquiry-template-id` string: Comma separated list of inquiry template IDs (starting with `itmpl_`) to filter inquiries by - `template-id` string: Comma separated list of legacy template IDs (starting with `tmpl_`) to filter inquiries by - `status` string: Comma separated list of statuses to filter inquiries by - `created-at-start` string, date-time: Filter inquiries by creation date, equal to or later than - `created-at-end` string, date-time: Filter inquiries by creation date, earlier than or equal to ## Headers - `Key-Inflection` 'camel' | 'kebab' | 'snake' - `Idempotency-Key` string - `Persona-Version` '2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18': Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning). ## Response `200` This endpoint returns a collection of Inquiry objects. - InquiriesListAllInquiriesResponse200 - `data` Inquiry[], required: An array of Inquiries - `id` string, required - `attributes` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributes, required - `status` string, required: The status of the Inquiry Possible values: - created - pending - completed - expired - failed - needs_review - approved - declined Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `reference-id` string, nullable, required - `note` string, nullable, required - `behaviors` object, nullable, required: Risk signals surfaced to enterprise customers. Specific keys are not enumerated in the public spec and may be added or removed over time. Contact your Persona account team for more information. - `tags` string[], required - `creator` string, required - `reviewer-comment` string, nullable, required - `created-at` string, date-time, required - `updated-at` string, date-time, required - `started-at` string, date-time, nullable, required - `expires-at` string, date-time, nullable, required - `completed-at` string, date-time, nullable, required - `failed-at` string, date-time, nullable, required: Set when an Inquiry transitions to `failed`. Not typically set on `declined` Inquiries — those carry `completed-at` from the transition that preceded the decision. - `marked-for-review-at` string, date-time, nullable, required - `decisioned-at` string, date-time, nullable, required - `expired-at` string, date-time, nullable, required - `redacted-at` string, date-time, nullable, required - `previous-step-name` string, nullable, required - `next-step-name` string, nullable, required - `fields` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFields, required: JSON key-value pairs of field name to field value. Exact schema depends on the configuration of the Inquiry template for this Inquiry. Keys in `fields` are **not** key inflected. - `name-first` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsNameFirst - `type` string - `value` string, nullable - `name-middle` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsNameMiddle - `type` string - `value` string, nullable - `name-last` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsNameLast - `type` string - `value` string, nullable - `address-street-1` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsAddressStreet1 - `type` string - `value` string, nullable - `address-street-2` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsAddressStreet2 - `type` string - `value` string, nullable - `address-city` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsAddressCity: City of residence address. Not all international addresses use this attribute. - `type` string - `value` string, nullable - `address-subdivision` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsAddressSubdivision: State or subdivision of residence address. In the US, this should be the unabbreviated name. Not all international addresses use this attribute. - `type` string - `value` string, nullable - `address-postal-code` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsAddressPostalCode: ZIP or postal code of residence address. Not all international addresses use this attribute. - `type` string - `value` string, nullable - `address-country-code` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsAddressCountryCode: ISO 3166-1 alpha 2 country code. - `type` string - `value` string, nullable - `birthdate` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsBirthdate - `type` string - `value` string, nullable: Date of birth in YYYY-MM-DD format - `email-address` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsEmailAddress - `type` string - `value` string, nullable - `phone-number` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsPhoneNumber - `type` string - `value` string, nullable - `identification-number` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFieldsIdentificationNumber - `type` string - `value` string, nullable - `relationships` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationships, required - `account` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsAccount - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsAccountData - `id` string - `type` 'account' - `documents` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsDocuments - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsDocumentsDataItems[] - `id` string - `type` string - `template` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsTemplate: Only present for Legacy 2.0 inquiries - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsTemplateData - `id` string - `type` 'template' - `inquiry-template` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsInquiryTemplate: Only present for Dynamic Flow inquiries - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsInquiryTemplateData - `id` string - `type` 'inquiry-template' - `inquiry-template-version` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsInquiryTemplateVersion: Only present for Dynamic Flow inquiries - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsInquiryTemplateVersionData - `id` string - `type` 'inquiry-template-version' - `reports` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsReports - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsReportsDataItems[] - `id` string - `type` string - `transaction` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsTransaction - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsTransactionData - `id` string - `type` 'transaction' - `reviewer` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsReviewer: Actor that decisioned the Inquiry. `data` is `null` while the Inquiry has not been decisioned. Once decisioned, `data.type` and `data.id` identify the reviewer: - `user` + `user_*` — a dashboard user reviewed and decisioned the Inquiry. - `workflow` + `wfl_*` — Workflows 1.0 auto-decisioned the Inquiry. - `workflow-run` + `wfr_*` — Workflows 2.0 auto-decisioned the Inquiry (the dominant case in automation-heavy organizations). - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsReviewerData - `id` string - `type` string: One of `user`, `workflow`, or `workflow-run`. - `selfies` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsSelfies - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsSelfiesDataItems[] - `id` string - `type` string - `sessions` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsSessions - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsSessionsDataItems[] - `id` string - `type` 'inquiry-session' - `verifications` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsVerifications - `data` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsVerificationsDataItems[] - `id` string - `type` string - `links` InquiriesGetResponsesContentApplicationJsonSchemaLinks, required - `prev` string, nullable, required: URL pointing to the previous page of data, or null if on the first page. - `next` string, nullable, required: URL pointing to the next page of data, or null if on the last page. ## Other responses - `400`: The request was unacceptable, often due to invalid parameters. - `401`: An invalid API key was provided. - `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded. - `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests. --- [API](https://skmtc.dev/withpersona/apis/withpersona-6.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-6/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-6/revisions/b2a170061bd9?raw)