About
Below is a log of changes to the Persona API. Updates that affect only products or features in beta or limited release may not be reflected.
Each change can be described as either a breaking change or an ongoing change.
- Breaking changes = new API version: When we make any backwards-incompatible changes, we release a new version of the API. In addition to being assigned a new API version, these changes are marked in the changelog with the π₯ symbol. Youβre in charge of when you get breaking changesβyou get them when you upgrade your API version. Learn how to try out and upgrade to newer API versions.
- Ongoing changes: Ongoing changes are backwards-compatible, and are added on an ongoing basis. You donβt need to update your API version to get these updates.
Key
π± New feature
π Improvement
π§ Fix
π₯ Breaking change
π Security-related
Accounts
- π±Add endpoint to run an Account action: You can now run an account action via API.
User Audit Logs
- πAdd
context.inquiry_idattribute to User Audit Logs: User Audit Log resources now include acontext.inquiry_idattribute to retrieve theinquiry-idof an inquiry created via dashboard.
Tags
- π₯ Active tags limited to 1000 per organization: API requests that would result in additional tags being created will receive 422 response code if the organization has at least 1000 tags currently active.
Verifications
- π Add
non-domiciledto the list of possible ID designations:non-domiciledis now among the list of possible ID designations.
Lists
- π Allow creating String Lists via API: You can now create String Lists via API.
Accounts
- π Allow filtering Accounts by multiple reference IDs: You can now list all Accounts by filtering on an array of reference IDs.
Verifications
- π Add
accountrelationship to Verifications: Verification resources now include the relatedaccountindata.relationships. This allows you to determine which Account a given Verification is associated with directly from the response, without making an additional query.
Verifications
- π Add
redacted-atto Verifications: Verification resources now include aredacted-atattribute, which will be the timestamp of when the Verification was redacted, if applicable.
Cross-API
- π Add
page-countto File field schema: Responses that include field schemas with typeFieldSchema::Filewill include the page count for newly created files or files with updated parent Persona object (Inquiry/Account/Transaction). Non-PDF format files will default to a page count of 1.
API Keys
- π Extend maximum file access token expiry to 3 days: API keys can now be configured (via the
file-access-token-expires-inparameter) to return file URLs that have access tokens that are valid for up to 3 days. The previous maximum was 1 day. For more info, see Downloading Files.
Webhooks
- π Extend maximum file access token expiry to 3 days: Webhooks can now be configured (via the
file-access-token-expires-inparameter) to return file URLs that have access tokens that are valid for up to 3 days. The previous maximum was 1 day. For more info, see Downloading Files.
User Audit Logs
- π Add
response-statusattribute to User Audit Logs: User Audit Logs resources now include aresponse-statusattribute, which indicates the HTTP response of the request. - π Update
get-paramsandpost-paramstyping: User Audit Logsget-paramsandpost-paramsattributes can now be a string in addition to an object.
Verifications
- πAdd
tagsattribute to Verifications: Verifications resources now includetagsthat are associated with the verification.
Workflows
- πΒ Access workflow deployment and version details: You can now request the
active-deploymentandlatest-published-versioninformation viaincludewhen querying for a specific workflow.
Accounts
- π Add max-file-size-bytes to File field schema: File field schemas now include a max-file-size-bytes attribute. This allows you to specify the maximum file size (in bytes) that can be uploaded for a given file field. The default is 10,000,000 bytes (10MB). This gives developers finer control over file uploads when designing templates and forms.
Inquiries
- πΒ Filter Inquiries by
inquiry_id(s):Β You can now list inquiries withinquiry_idin thefilterquery parameter. There is a maximum of 100inquiry_idsthat can be passed in at a time.

