# Coris API > Coris is an AI platform for merchant and payment risk. The API covers KYB, merchant underwriting, and merchant monitoring for payment platforms, ISOs, PayFacs, and sponsor banks. Alert and dispute work happens in the Coris portal, and webhooks deliver alerts. - Every page below is also served as Markdown. The links use the `.md` form. - Authenticate with `Authorization: Token `. Use the `Token` prefix on every request. - Sandbox base URL: `https://sandbox-api.coris.ai/api/v0_2`. Production base URL: `https://api.coris.ai/api/v0_2`. - Build against the sandbox. Use production only when your user asks for it. - Long-running calls return a `request_id`. Poll the same path with `?request_id=`: `425` means wait, `206` means partial results, `200` means done. - The API has no `Idempotency-Key` support. Each async POST starts a new run, so do not retry one after an unknown outcome without checking first. - Alert and dispute endpoints are in the partner reference. To request it, see [Get access to Coris](https://docs.coris.ai/docs/get-access.md). ## Start here - [Merchant risk API overview](https://docs.coris.ai/docs/what-is-the-coris-api.md): See what the Coris API does: KYB, merchant underwriting, and merchant monitoring from one API for payment platforms, ISOs, and PayFacs. - [Get access to Coris](https://docs.coris.ai/docs/get-access.md): Get access to Coris: request a sandbox for KYB and merchant monitoring, get a portal login or a feature turned on, or start a security review. - [Make your first API call](https://docs.coris.ai/docs/quickstart.md): Run your first KYB call in the sandbox: start a Merchant Profiler request, poll for the result, and fetch the business by its establishment ID. - [Understand the data model](https://docs.coris.ai/docs/core-concepts.md): Learn how business, establishment, legal entity, and account relate in the Coris data model, and which ID to use for KYB and monitoring calls. - [How Coris checks work](https://docs.coris.ai/docs/how-coris-checks-work.md): How Coris KYB checks work: data sources, coverage, sanctions and AML screening, CorShield risk scores, turnaround and the audit trail. - [Monitoring and alerts explained](https://docs.coris.ai/docs/monitoring-and-alerts.md): How Coris merchant monitoring works: the alert categories, when checks run, an example rule, and how to filter alerts by ISO and track outcomes. - [Authenticate API requests](https://docs.coris.ai/docs/authentication.md): Authenticate Coris business verification API requests with an Authorization: Token header, and keep sandbox and production keys separate. - [Security and compliance](https://docs.coris.ai/docs/security.md): Coris security for KYB and merchant monitoring reviews: SOC 2 Type II, GDPR, API key controls, stored data, and the Stripe and Adyen access needed. - [Test in the sandbox](https://docs.coris.ai/docs/sandbox.md): Test your KYB integration in the Coris sandbox: mocked business data, fixed test scenarios, and how sandbox results differ from production. - [Rules for coding agents](https://docs.coris.ai/docs/agents.md): Rules for AI coding agents that call the Coris API: authentication, sandbox and production, async polling, retries and versioning for KYB. ## Business and KYB data: lenders, marketplaces, and underwriting fintechs - [Integrate business data for KYB](https://docs.coris.ai/docs/integrate-business-data.md): Integration path for lenders and marketplaces: run Merchant Profiler or create an account for KYB and merchant underwriting data, then act on the result. - [Verify a business at onboarding](https://docs.coris.ai/docs/verify-a-business-at-onboarding.md): Run KYB at onboarding with the Coris business verification API: registration and TIN matches, OFAC and AML screening, and a CorShield risk score. - [Underwrite a merchant](https://docs.coris.ai/docs/underwrite-a-merchant.md): Run merchant underwriting with Merchant Profiler: request one profile, read its registration, website, and review data, then create the account. ## Fintechs, ISOs and sponsor banks on the Coris platform - [Integrate as a fintech, ISO or sponsor bank](https://docs.coris.ai/docs/integrate-fintech-iso-platform.md): Integration path for fintechs, ISOs and sponsor banks: load portfolio data by file or API so Coris runs merchant monitoring and sends alerts. - [Monitor your merchant portfolio](https://docs.coris.ai/docs/monitor-your-portfolio.md): Set up merchant monitoring for your portfolio: subscribe to alert webhooks, start monitoring an account, and stop it when a merchant leaves. - [Triage transaction alerts](https://docs.coris.ai/docs/triage-transaction-alerts.md): Triage transaction alerts in your merchant monitoring workflow: subscribe to alert webhooks, review in the portal, and record outcomes with tags. - [Respond to disputes](https://docs.coris.ai/docs/respond-to-disputes.md): Bring chargebacks into your merchant monitoring workflow: report disputed transactions, load Stripe disputes, and work each case in the portal. - [File formats for portfolio uploads](https://docs.coris.ai/docs/file-formats.md): File formats for Coris merchant monitoring uploads: your processor's native files or a custom format, set up with Coris, and what each file type carries. ## SaaS platforms on Stripe or Adyen Connect - [Integrate a SaaS platform](https://docs.coris.ai/docs/integrate-saas-platform.md): Integration path for SaaS platforms on Stripe or Adyen: connect once, then Coris runs KYB and merchant monitoring from processor events. - [Connect Stripe and Adyen](https://docs.coris.ai/docs/connect-stripe-and-adyen.md): Connect Stripe in the portal, or Adyen with help from Coris, so processor events start KYB and merchant monitoring with no direct calls. ## Build and operate - [Handle async requests](https://docs.coris.ai/docs/async-requests.md): Handle long-running KYB and merchant underwriting calls: start a run, poll request_id through 425, 206, and 200, or receive a callback instead. - [Receive webhooks](https://docs.coris.ai/docs/webhooks.md): Receive Coris webhooks when tags, alerts, and notes change: register an endpoint, verify Coris-Signature, and handle merchant monitoring events. - [Handle API errors](https://docs.coris.ai/docs/errors.md): Handle errors from the Coris business verification API: what each status code means, the body formats you receive, and how to fix each cause. - [Rate limits and pagination](https://docs.coris.ai/docs/rate-limits-and-pagination.md): Stay within Coris API rate limits and page through merchant monitoring data with limit, offset, and cursors. Covers 429 and concurrency limits. - [API versioning](https://docs.coris.ai/docs/versioning.md): /api/v0_2 is the stable path of the Coris business verification API. See your dated workspace version and the 90-day deprecation policy. - [API glossary](https://docs.coris.ai/docs/glossary.md): Definitions of Coris API terms for KYB and merchant monitoring: business, account, establishment, legal entity, MCC, OFAC, PayFac, and sponsor bank. ## API reference: Merchant Profiler - [Create a Merchant Profiler request](https://docs.coris.ai/reference/create-merchant-profiler-request.md): `POST /merchant_profiler/`. Starts a job that matches a business from your details and collects its profile: registration, people, website, reviews, ratings and risk checks. - [Get a Merchant Profiler result](https://docs.coris.ai/reference/get-merchant-profiler-result.md): `GET /merchant_profiler/`. Returns the result of Create a Merchant Profiler request, so call it with that request_id until you get 200. ## API reference: CorShield - [Run a CorShield evaluation](https://docs.coris.ai/reference/run-corshield-evaluation.md): `POST /corshield/fraud_model/`. Starts a CorShield evaluation of a business application and returns a request_id. - [Get a CorShield evaluation result](https://docs.coris.ai/reference/get-corshield-evaluation-result.md): `GET /corshield/fraud_model/`. Returns the result of Run a CorShield evaluation. - [Get an account's CorShield evaluation](https://docs.coris.ai/reference/get-corshield-evaluation.md): `GET /accounts/{account_id}/corshield/evaluation/`. Returns the most recent CorShield evaluation stored for an account, or an empty object if it has none. ## API reference: Business Search - [Search businesses](https://docs.coris.ai/reference/search-businesses.md): `POST /business/search/`. Starts a search for businesses that match the details you send, so you can review the matches and pick the right establishment.id and legal_entity.id. - [Get business search results](https://docs.coris.ai/reference/get-business-search-results.md): `GET /business/search/`. Returns the matches from Search businesses. ## API reference: Business Prefill - [Search prefill candidates](https://docs.coris.ai/reference/search-prefill-candidates.md): `POST /prefill/`. Searches business filing records by legal name and state, and returns masked candidates with a request_id right away. - [Get prefill status](https://docs.coris.ai/reference/get-prefill-status.md): `GET /prefill/{request_id}/`. Returns the current prefill data for a request started with Run prefill enrichment, so you can fill form fields as they become available. - [Run prefill enrichment](https://docs.coris.ai/reference/run-prefill-enrichment.md): `POST /prefill/{request_id}/run/`. Starts enrichment for one candidate from Search prefill candidates, after the applicant picks their business. ## API reference: Business Verification - [Verify a business](https://docs.coris.ai/reference/verify-business.md): `POST /business/verification/`. Starts a KYB check of a legal name and address against Secretary of State records, with optional TIN verification and OFAC/AML screening. - [Get business verification results](https://docs.coris.ai/reference/get-business-verification.md): `GET /business/verification/`. Returns the result of Verify a business. ## API reference: Establishment - [Get an establishment](https://docs.coris.ai/reference/get-establishment.md): `GET /establishment/{establishment_id}/`. - [Request establishment adverse media](https://docs.coris.ai/reference/request-establishment-adverse-media.md): `POST /establishment/{establishment_id}/adverse_media/`. Use this when you hold an establishment.id: it starts a job to screen a business for negative news. - [Get establishment adverse media](https://docs.coris.ai/reference/get-establishment-adverse-media.md): `GET /establishment/{establishment_id}/adverse_media/`. Use this when you hold an establishment.id: it returns negative news found for a business. - [Request establishment industry](https://docs.coris.ai/reference/request-establishment-industry.md): `POST /establishment/{establishment_id}/industry/`. Use this when you hold an establishment.id: it starts a job to classify a business by NAICS and MCC code. - [Get establishment industry](https://docs.coris.ai/reference/get-establishment-industry.md): `GET /establishment/{establishment_id}/industry/`. Use this when you hold an establishment.id: it returns the NAICS and MCC classification of a business. - [Get establishment licenses](https://docs.coris.ai/reference/get-establishment-licenses.md): `GET /establishment/{establishment_id}/licenses/`. Returns the licenses found for an establishment. - [Request establishment litigation](https://docs.coris.ai/reference/request-establishment-litigation.md): `POST /establishment/{establishment_id}/litigation_checker/`. Use this when you hold an establishment.id: it starts a job to find litigation records for a business. - [Get establishment litigation](https://docs.coris.ai/reference/get-establishment-litigation.md): `GET /establishment/{establishment_id}/litigation_checker/`. Use this when you hold an establishment.id: it returns litigation records found for a business. - [Request litigation presence](https://docs.coris.ai/reference/request-establishment-litigation-presence.md): `POST /establishment/{establishment_id}/litigation_presence_checker/`. Use this when you hold an establishment.id: it starts a job to check whether a business has litigation records. - [Get litigation presence](https://docs.coris.ai/reference/get-establishment-litigation-presence.md): `GET /establishment/{establishment_id}/litigation_presence_checker/`. Use this when you hold an establishment.id: it returns whether a business has litigation records. - [Request a PDF report](https://docs.coris.ai/reference/request-establishment-pdf-report.md): `POST /establishment/{establishment_id}/merchant_profiler_pdf_report/`. Use this when you hold an establishment.id: it starts a job to build a PDF report of an establishment's data, and returns a request_id. - [Get a PDF report](https://docs.coris.ai/reference/get-establishment-pdf-report.md): `GET /establishment/{establishment_id}/merchant_profiler_pdf_report/`. Use this when you hold an establishment.id: it returns a link to a PDF report of an establishment's data. - [Request establishment Merchant Vision](https://docs.coris.ai/reference/request-establishment-merchant-vision.md): `POST /establishment/{establishment_id}/merchant_vision/`. Use this when you hold an establishment.id: it starts a job to analyze street-level imagery of a business location. - [Get establishment Merchant Vision](https://docs.coris.ai/reference/get-establishment-merchant-vision.md): `GET /establishment/{establishment_id}/merchant_vision/`. Use this when you hold an establishment.id: it returns the imagery analysis of a business location, such as the property type and any business names shown. - [Get establishment phones](https://docs.coris.ai/reference/get-establishment-phones.md): `GET /establishment/{establishment_id}/phones/`. Returns the phone numbers found for an establishment. - [Request establishment rating](https://docs.coris.ai/reference/request-establishment-ratings.md): `POST /establishment/{establishment_id}/ratings/`. Use this when you hold an establishment.id: it starts a job to rate a business and its website. - [Get establishment rating](https://docs.coris.ai/reference/get-establishment-ratings.md): `GET /establishment/{establishment_id}/ratings/`. Use this when you hold an establishment.id: it returns the Coris ratings of a business and its website. - [Refresh phone metadata](https://docs.coris.ai/reference/request-establishment-phone-metadata.md): `POST /establishment/{establishment_id}/phones/metadata/`. Starts a job to refresh metadata for an establishment's phone numbers. - [Get phone metadata status](https://docs.coris.ai/reference/get-establishment-phone-metadata.md): `GET /establishment/{establishment_id}/phones/metadata/`. Returns the state of a refresh started with Refresh phone metadata. ## API reference: Legal Entity - [Get a legal entity](https://docs.coris.ai/reference/get-legal-entity.md): `GET /legal_entity/{legal_entity_id}/`. Returns a legal entity: the registered owner of a business. - [Request legal entity agents](https://docs.coris.ai/reference/request-legal-entity-agents.md): `POST /legal_entity/{legal_entity_id}/agents/`. Starts a job to find the people and organizations that can act for a business. - [Get legal entity agents](https://docs.coris.ai/reference/get-legal-entity-agents.md): `GET /legal_entity/{legal_entity_id}/agents/`. Returns the people and organizations that can act for a business. - [Request legal entity licenses](https://docs.coris.ai/reference/request-legal-entity-licenses.md): `POST /legal_entity/{legal_entity_id}/licenses/`. Starts a job to find the licenses held by a legal entity. - [Get legal entity licenses](https://docs.coris.ai/reference/get-legal-entity-licenses.md): `GET /legal_entity/{legal_entity_id}/licenses/`. Returns the licenses held by a legal entity. - [Request OFAC and AML screening](https://docs.coris.ai/reference/request-legal-entity-ofac-aml.md): `POST /legal_entity/{legal_entity_id}/ofac_aml/`. Starts a job to screen a legal entity against OFAC sanctions and AML lists. - [Get OFAC and AML screening](https://docs.coris.ai/reference/get-legal-entity-ofac-aml.md): `GET /legal_entity/{legal_entity_id}/ofac_aml/`. Returns the OFAC and AML screening of a legal entity. - [Request registrations](https://docs.coris.ai/reference/request-legal-entity-registrations.md): `POST /legal_entity/{legal_entity_id}/registrations/`. Starts a job to find a legal entity's registrations, such as Secretary of State filings. - [Get legal entity registrations](https://docs.coris.ai/reference/get-legal-entity-registrations.md): `GET /legal_entity/{legal_entity_id}/registrations/`. Returns a legal entity's registrations. ## API reference: Website - [Request website attributes](https://docs.coris.ai/reference/request-website-attributes.md): `POST /websites/`. Starts a job to analyze a website, by URL or by establishment_id. - [Get website attributes](https://docs.coris.ai/reference/get-website-attributes.md): `GET /websites/`. Returns the attributes of a website. - [Request account websites](https://docs.coris.ai/reference/request-account-websites.md): `POST /accounts/{account_id}/websites/`. Starts a job to get attributes for each website on an account, and adds new URLs in websites to the account. - [List account websites](https://docs.coris.ai/reference/list-account-websites.md): `GET /accounts/{account_id}/websites/`. Lists the websites on an account, with their source. - [Update account websites](https://docs.coris.ai/reference/update-account-website.md): `PUT /accounts/{account_id}/websites/`. Adds and removes websites on an account, and returns the full list. - [Request establishment website](https://docs.coris.ai/reference/request-establishment-website.md): `POST /establishment/{establishment_id}/website/`. Use this when you hold an establishment.id: it starts a job to analyze the website of a business. - [Get establishment website](https://docs.coris.ai/reference/get-establishment-website.md): `GET /establishment/{establishment_id}/website/`. Use this when you hold an establishment.id: it returns the attributes of the website of a business. - [Request account website](https://docs.coris.ai/reference/request-account-website.md): `POST /accounts/{account_id}/establishment/website/`. Use this when you hold an account ID or reference_id: it starts a job to analyze the primary website of an account. - [Get account website](https://docs.coris.ai/reference/get-account-website.md): `GET /accounts/{account_id}/establishment/website/`. Use this when you hold an account ID or reference_id: it returns the attributes of an account's primary website. ## API reference: Reviews - [Request a review summary](https://docs.coris.ai/reference/request-reviews.md): `POST /reviews/`. Starts a job to summarize customer reviews of a business, by establishment_id. - [Get a review summary](https://docs.coris.ai/reference/get-reviews.md): `GET /reviews/`. Returns a summary of customer reviews of a business. - [Get reviews by source](https://docs.coris.ai/reference/get-reviews-by-source.md): `GET /reviews/{review_source}/`. Returns customer reviews of a business from one source. - [Request reviews by source](https://docs.coris.ai/reference/request-reviews-by-source.md): `POST /reviews/{review_source}/`. Starts a job to collect customer reviews of a business from one source, by establishment_id. - [Request establishment reviews](https://docs.coris.ai/reference/request-establishment-reviews.md): `POST /establishment/{establishment_id}/reviews/`. Use this when you hold an establishment.id: it starts a job to summarize customer reviews of a business across sources. - [Get establishment reviews](https://docs.coris.ai/reference/get-establishment-reviews.md): `GET /establishment/{establishment_id}/reviews/`. Use this when you hold an establishment.id: it returns a summary of customer reviews of a business, by source. - [Request account reviews](https://docs.coris.ai/reference/request-account-reviews.md): `POST /accounts/{account_id}/establishment/reviews/`. Use this when you hold an account ID or reference_id: it starts a job to summarize customer reviews of an account's business across sources. - [Get account reviews](https://docs.coris.ai/reference/get-account-reviews.md): `GET /accounts/{account_id}/establishment/reviews/`. Use this when you hold an account ID or reference_id: it returns a summary of customer reviews of an account's business, by source. - [Get establishment reviews by source](https://docs.coris.ai/reference/get-establishment-reviews-by-source.md): `GET /establishment/{establishment_id}/reviews/{review_source}/`. Returns customer reviews of a business from one source. - [Request establishment reviews by source](https://docs.coris.ai/reference/request-establishment-reviews-by-source.md): `POST /establishment/{establishment_id}/reviews/{review_source}/`. Starts a job to collect customer reviews of a business from one source. ## API reference: Social Media - [Request establishment social media](https://docs.coris.ai/reference/request-establishment-social-media.md): `POST /establishment/{establishment_id}/social_media/`. Use this when you hold an establishment.id: it starts a job to find and summarize the social media profiles of a business. - [Get establishment social media](https://docs.coris.ai/reference/get-establishment-social-media.md): `GET /establishment/{establishment_id}/social_media/`. Use this when you hold an establishment.id: it returns a summary of the social media profiles of a business. - [Request account social media](https://docs.coris.ai/reference/request-account-social-media.md): `POST /accounts/{account_id}/establishment/social_media/`. Use this when you hold an account ID or reference_id: it starts a job to find and summarize the social media profiles of an account's business. - [Get account social media](https://docs.coris.ai/reference/get-account-social-media.md): `GET /accounts/{account_id}/establishment/social_media/`. Use this when you hold an account ID or reference_id: it returns a summary of the social media profiles of an account's business. - [Get social media by platform](https://docs.coris.ai/reference/get-establishment-social-media-by-platform.md): `GET /establishment/{establishment_id}/social_media/{social_media_platform}/`. Returns the profile of a business on one social media platform. - [Request social media by platform](https://docs.coris.ai/reference/request-establishment-social-media-by-platform.md): `POST /establishment/{establishment_id}/social_media/{social_media_platform}/`. Starts a job to collect the profile of a business on one social media platform. - [Request establishment social media rating](https://docs.coris.ai/reference/request-establishment-social-media-rating.md): `POST /establishment/{establishment_id}/social_media/rating/`. Use this when you hold an establishment.id: it starts a job to rate the social media presence of a business. - [Get establishment social media rating](https://docs.coris.ai/reference/get-establishment-social-media-rating.md): `GET /establishment/{establishment_id}/social_media/rating/`. Use this when you hold an establishment.id: it returns the rating of the social media presence of a business. - [Request account social media rating](https://docs.coris.ai/reference/request-account-social-media-rating.md): `POST /accounts/{account_id}/establishment/social_media/rating/`. Use this when you hold an account ID or reference_id: it starts a job to rate the social media presence of an account's business. - [Get account social media rating](https://docs.coris.ai/reference/get-account-social-media-rating.md): `GET /accounts/{account_id}/establishment/social_media/rating/`. Use this when you hold an account ID or reference_id: it returns the rating of the social media presence of an account's business. ## API reference: Personnel - [Get establishment personnel](https://docs.coris.ai/reference/get-establishment-personnel.md): `GET /establishment/{establishment_id}/personnel/`. Returns the people linked to an establishment. - [Request legal entity personnel](https://docs.coris.ai/reference/request-legal-entity-personnel.md): `POST /legal_entity/{legal_entity_id}/personnel/`. Starts a job to find people linked to a legal entity. - [Get legal entity personnel](https://docs.coris.ai/reference/get-legal-entity-personnel.md): `GET /legal_entity/{legal_entity_id}/personnel/`. Returns the people linked to a legal entity. - [Request personnel agents](https://docs.coris.ai/reference/request-legal-entity-personnel-agents.md): `POST /legal_entity/{legal_entity_id}/personnel/agents/`. Starts a job to find people linked to a legal entity who act as agents. - [Get personnel agents](https://docs.coris.ai/reference/get-legal-entity-personnel-agents.md): `GET /legal_entity/{legal_entity_id}/personnel/agents/`. Returns the people linked to a legal entity who act as agents. ## API reference: Accounts - [Create an account](https://docs.coris.ai/reference/create-account.md): `POST /accounts/`. Creates an account, your record of a merchant in your portfolio, so that you can push persons and transactions and turn on monitoring. - [List accounts](https://docs.coris.ai/reference/list-accounts.md): `GET /accounts/`. Lists the accounts in your workspace, with filters, or returns the result of Create an account when you send request_id. - [Get an account](https://docs.coris.ai/reference/get-account.md): `GET /accounts/{account_id}/`. Returns one account by its Coris ID or your reference_id. - [Update an account](https://docs.coris.ai/reference/update-account.md): `POST /accounts/{account_id}/`. Changes details on an account and returns the updated account, so the change is complete when the response arrives. - [Delete an account](https://docs.coris.ai/reference/delete-account.md): `DELETE /accounts/{account_id}/`. Deletes an account and any alerts on it and returns 204, when a merchant leaves your portfolio. - [Update account metadata](https://docs.coris.ai/reference/update-account-metadata.md): `POST /accounts/{account_id}/metadata/`. Adds or changes key-value metadata on an account, and returns the full list. - [Get account metadata](https://docs.coris.ai/reference/get-account-metadata.md): `GET /accounts/{account_id}/metadata/`. Returns the metadata on an account as key, value and source. ## API reference: Persons - [Add a person to an account](https://docs.coris.ai/reference/create-account-person.md): `POST /accounts/{account_id}/persons/`. Adds a beneficial owner, controller or other person to an account for KYC, once per person, after Create an account. - [List account persons](https://docs.coris.ai/reference/list-account-persons.md): `GET /accounts/{account_id}/persons/`. Returns every person on an account: those you added, plus those from a connected Stripe account. - [Get an account person](https://docs.coris.ai/reference/get-account-person.md): `GET /accounts/{account_id}/persons/{person_id}/`. Returns one person on an account. - [Update an account person](https://docs.coris.ai/reference/update-account-person.md): `POST /accounts/{account_id}/persons/{person_id}/`. Changes details of a person on an account. - [Delete an account person](https://docs.coris.ai/reference/delete-account-person.md): `DELETE /accounts/{account_id}/persons/{person_id}/`. Removes a person from an account, with any ID number on file and returns 204. ## API reference: Monitoring - [Start account monitoring](https://docs.coris.ai/reference/start-account-monitoring.md): `POST /accounts/{account_id}/monitor/`. Turns on monitoring for an account. - [Stop account monitoring](https://docs.coris.ai/reference/stop-account-monitoring.md): `POST /accounts/{account_id}/stop_monitoring/`. Turns off monitoring for an account and returns plain text, and Start account monitoring turns it back on. ## API reference: Account Data - [Request account adverse media](https://docs.coris.ai/reference/request-account-adverse-media.md): `POST /accounts/{account_id}/adverse_media/`. Use this when you hold an account ID or reference_id: it starts a job to screen an account's business for negative news. - [Get account adverse media](https://docs.coris.ai/reference/get-account-adverse-media.md): `GET /accounts/{account_id}/adverse_media/`. Use this when you hold an account ID or reference_id: it returns negative news found for an account's business. - [Get an account's establishment](https://docs.coris.ai/reference/get-account-establishment.md): `GET /accounts/{account_id}/establishment/`. Use this when you hold an account ID or reference_id: it returns the establishment linked to the account. - [Request account litigation](https://docs.coris.ai/reference/request-account-litigation.md): `POST /accounts/{account_id}/litigation_checker/`. Use this when you hold an account ID or reference_id: it starts a job to find litigation records for an account's business. - [Get account litigation](https://docs.coris.ai/reference/get-account-litigation.md): `GET /accounts/{account_id}/litigation_checker/`. Use this when you hold an account ID or reference_id: it returns litigation records found for an account's business. - [Request account litigation presence](https://docs.coris.ai/reference/request-account-litigation-presence.md): `POST /accounts/{account_id}/litigation_presence_checker/`. Use this when you hold an account ID or reference_id: it starts a job to check whether an account's business has litigation records. - [Get account litigation presence](https://docs.coris.ai/reference/get-account-litigation-presence.md): `GET /accounts/{account_id}/litigation_presence_checker/`. Use this when you hold an account ID or reference_id: it returns whether an account's business has litigation records. - [Request an account PDF report](https://docs.coris.ai/reference/request-account-pdf-report.md): `POST /accounts/{account_id}/merchant_profiler_pdf_report/`. Use this when you hold an account ID or reference_id: it starts a job to build a PDF report of an account's data. - [Get an account PDF report](https://docs.coris.ai/reference/get-account-pdf-report.md): `GET /accounts/{account_id}/merchant_profiler_pdf_report/`. Use this when you hold an account ID or reference_id: it returns a link to a PDF report of an account's data. - [Request account Merchant Vision](https://docs.coris.ai/reference/request-account-merchant-vision.md): `POST /accounts/{account_id}/merchant_vision/`. Use this when you hold an account ID or reference_id: it starts a job to analyze street-level imagery of an account's business location. - [Get account Merchant Vision](https://docs.coris.ai/reference/get-account-merchant-vision.md): `GET /accounts/{account_id}/merchant_vision/`. Use this when you hold an account ID or reference_id: it returns the imagery analysis of an account's business location. - [Request account industry](https://docs.coris.ai/reference/request-account-industry.md): `POST /accounts/{account_id}/establishment/industry/`. Use this when you hold an account ID or reference_id: it starts a job to classify an account's business by NAICS and MCC code. - [Get account industry](https://docs.coris.ai/reference/get-account-industry.md): `GET /accounts/{account_id}/establishment/industry/`. Use this when you hold an account ID or reference_id: it returns the NAICS and MCC classification of an account's business. - [Request account rating](https://docs.coris.ai/reference/request-account-ratings.md): `POST /accounts/{account_id}/establishment/ratings/`. Use this when you hold an account ID or reference_id: it starts a job to rate an account's business and website. - [Get account rating](https://docs.coris.ai/reference/get-account-ratings.md): `GET /accounts/{account_id}/establishment/ratings/`. Use this when you hold an account ID or reference_id: it returns the Coris ratings of an account's business and website. ## API reference: Account Tags - [Create an account tag](https://docs.coris.ai/reference/create-account-tag.md): `POST /account_tags/`. Defines an account tag: a label with a type, which you can set on any account. - [List account tags](https://docs.coris.ai/reference/list-account-tags.md): `GET /account_tags/`. Lists the tag definitions in your workspace, newest first by default. - [Get an account tag](https://docs.coris.ai/reference/get-account-tag.md): `GET /account_tags/{account_tag_id}/`. Returns one tag definition. - [Update an account tag](https://docs.coris.ai/reference/update-account-tag.md): `POST /account_tags/{account_tag_id}/`. Changes a tag definition, such as its name, description or allowed values. - [Delete an account tag](https://docs.coris.ai/reference/delete-account-tag.md): `DELETE /account_tags/{account_tag_id}/`. Deletes a tag definition and returns 200. - [Set an account tag](https://docs.coris.ai/reference/create-entity-account-tag.md): `POST /accounts/{account_id}/account_tags/`. Sets a tag on one account, using a tag defined with Create an account tag. - [List an account's tags](https://docs.coris.ai/reference/list-entity-account-tags.md): `GET /accounts/{account_id}/account_tags/`. Lists the tags set on an account, newest first by default. - [Get an account's tag](https://docs.coris.ai/reference/get-entity-account-tag.md): `GET /accounts/{account_id}/account_tags/{entity_account_tag_id}/`. Returns one tag value on an account. - [Update an account's tag](https://docs.coris.ai/reference/update-entity-account-tag.md): `POST /accounts/{account_id}/account_tags/{entity_account_tag_id}/`. Changes a tag value on an account. - [Remove an account's tag](https://docs.coris.ai/reference/delete-entity-account-tag.md): `DELETE /accounts/{account_id}/account_tags/{entity_account_tag_id}/`. Removes a tag value from an account and returns 200. ## API reference: Custom Lists - [Create a custom list](https://docs.coris.ai/reference/create-custom-list.md): `POST /settings/custom_list/`. Creates a named list, such as keywords or MCC codes, that your monitoring can use. - [List custom lists](https://docs.coris.ai/reference/list-custom-lists.md): `GET /settings/custom_list/`. Lists the custom lists in your workspace, with their items. - [Get a custom list](https://docs.coris.ai/reference/get-custom-list.md): `GET /settings/custom_list/{list_id}/`. Returns one custom list with its items. - [Update a custom list](https://docs.coris.ai/reference/update-custom-list.md): `POST /settings/custom_list/{list_id}/`. Changes a custom list. - [Delete a custom list](https://docs.coris.ai/reference/delete-custom-list.md): `DELETE /settings/custom_list/{list_id}/`. Deletes a custom list and returns 204. ## API reference: Transactions - [Update transaction metadata](https://docs.coris.ai/reference/update-transaction-metadata.md): `POST /transaction_metadata/`. Adds or changes your own key-value metadata on one Stripe payment and returns 202 even if the payment has not arrived. - [Get transaction metadata](https://docs.coris.ai/reference/get-transaction-metadata.md): `GET /transaction_metadata/`. Returns the metadata you stored on a Stripe payment. - [Create a transaction](https://docs.coris.ai/reference/create-account-transaction.md): `POST /accounts/{account_id}/transactions/`. Adds a transaction to an account, or updates it if the transaction_id already exists, so retries are safe. - [List account transactions](https://docs.coris.ai/reference/list-account-transactions.md): `GET /accounts/{account_id}/transactions/`. Lists the transactions on an account, whatever their source, with filters for status, amount and type. ## API reference: Transaction Tags - [Create a transaction tag](https://docs.coris.ai/reference/create-transaction-tag.md): `POST /transaction_tags/`. Defines a transaction tag: a label with a type, which you can set on any transaction. - [List transaction tags](https://docs.coris.ai/reference/list-transaction-tags.md): `GET /transaction_tags/`. Lists the transaction tag definitions in your workspace. - [Get a transaction tag](https://docs.coris.ai/reference/get-transaction-tag.md): `GET /transaction_tags/{transaction_tag_id}/`. Returns one transaction tag definition. - [Update a transaction tag](https://docs.coris.ai/reference/update-transaction-tag.md): `POST /transaction_tags/{transaction_tag_id}/`. Changes a transaction tag definition, such as its name, description or allowed values. - [Delete a transaction tag](https://docs.coris.ai/reference/delete-transaction-tag.md): `DELETE /transaction_tags/{transaction_tag_id}/`. Deletes a transaction tag definition and returns 200. ## API reference: Entity Transaction Tags - [List a transaction's tags](https://docs.coris.ai/reference/list-entity-transaction-tags.md): `GET /entity_transaction_tags/{entity_id}/`. Lists the tags set on one transaction. - [Set a transaction tag](https://docs.coris.ai/reference/create-entity-transaction-tag.md): `POST /entity_transaction_tags/{entity_id}/`. Sets a tag on one transaction and returns 201. - [Get a transaction's tag](https://docs.coris.ai/reference/get-entity-transaction-tag.md): `GET /entity_transaction_tags/{entity_id}/{entity_transaction_tag_id}/`. Returns one tag value on a transaction. - [Update a transaction's tag](https://docs.coris.ai/reference/update-entity-transaction-tag.md): `POST /entity_transaction_tags/{entity_id}/{entity_transaction_tag_id}/`. Changes a tag value on a transaction. - [Remove a transaction's tag](https://docs.coris.ai/reference/delete-entity-transaction-tag.md): `DELETE /entity_transaction_tags/{entity_id}/{entity_transaction_tag_id}/`. Removes a tag value from a transaction and returns 200. ## API reference: Webhooks - [Create a webhook endpoint](https://docs.coris.ai/reference/create-webhook.md): `POST /webhooks/`. Registers an HTTPS endpoint for tag, alert and note events, and returns its signing_secret. - [List webhook endpoints](https://docs.coris.ai/reference/list-webhooks.md): `GET /webhooks/`. Lists your webhook endpoints, 10 per page by default. - [Get a webhook endpoint](https://docs.coris.ai/reference/get-webhook.md): `GET /webhooks/{webhook_id}/`. Returns one webhook endpoint, including its signing_secret. - [Update a webhook endpoint](https://docs.coris.ai/reference/update-webhook.md): `POST /webhooks/{webhook_id}/`. Changes the name, description and event subscriptions of an endpoint. - [Delete a webhook endpoint](https://docs.coris.ai/reference/delete-webhook.md): `DELETE /webhooks/{webhook_id}/`. Deletes a webhook endpoint and returns 204. - [Disable a webhook endpoint](https://docs.coris.ai/reference/disable-webhook.md): `POST /webhooks/{webhook_id}/disable/`. Stops delivery to an endpoint and keeps its settings. - [Enable a webhook endpoint](https://docs.coris.ai/reference/enable-webhook.md): `POST /webhooks/{webhook_id}/enable/`. Resumes delivery to a disabled endpoint. - [List webhook events](https://docs.coris.ai/reference/list-webhook-events.md): `GET /webhooks/{webhook_id}/events/`. Lists every webhook event in your workspace, not only this endpoint's subscriptions. - [List event deliveries](https://docs.coris.ai/reference/list-webhook-event-deliveries.md): `GET /webhooks/events/{webhook_event_id}/deliveries/`. Lists the deliveries for one webhook event, with response codes and timing, 10 per page by default. ## API reference: File Uploads - [Create a file upload](https://docs.coris.ai/reference/create-file-upload.md): `POST /file_uploads/`. Creates a file upload record with status pending, and returns its id. - [Get a file upload](https://docs.coris.ai/reference/get-file-upload.md): `GET /file_uploads/{file_upload_id}/`. Returns a file upload record, so you can confirm that Coris received your file. - [Upload file content](https://docs.coris.ai/reference/upload-file-content.md): `PUT /file_uploads/{file_upload_id}/`. Sends the file for a pending record from Create a file upload, as multipart/form-data in the file field. ## Optional - [Guides index](https://docs.coris.ai/docs/llms.txt): ReadMe's generated index of every guide. - [Reference index](https://docs.coris.ai/reference/llms.txt): ReadMe's generated index of every endpoint.