{
  "openapi": "3.1.0",
  "info": {
    "title": "AccreditedNow Verification API",
    "version": "1.0.0",
    "summary": "Create and track CPA-signed accredited investor verifications (Rule 506(c)).",
    "description": "Server-to-server API for sponsors and platforms. Verification is asynchronous: create a verification, send the investor the hosted_url, and a licensed CPA signs the letter (typically within 24 hours). Learn the outcome from the signed webhooks (see `webhooks`) or by polling. Responses never contain the investor's documents, financial figures, identity documents or resume token. Human-readable docs: https://accreditednow.org/verification-api",
    "termsOfService": "https://accreditednow.org/api-terms",
    "contact": {
      "name": "AccreditedNow",
      "email": "info@accreditednow.org",
      "url": "https://accreditednow.org/verification-api"
    }
  },
  "servers": [
    {
      "url": "https://accreditednow.org/v1"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Verifications",
      "description": "Create, list and read verifications, and download consent-shared letters."
    },
    {
      "name": "Sandbox",
      "description": "Test-key only helpers. Sandbox calls never create a real case, use a seat or charge anything."
    },
    {
      "name": "Funds",
      "description": "Group your verifications by fund or raise. One firm, many funds; the firm's business check is done once."
    },
    {
      "name": "Screenings",
      "description": "Screening only: sanctions and PEP screening plus ongoing monitoring for people who don't need a CPA letter (for example non-US Reg S investors). No CPA review, no seat, no letter. Each person counts toward your firm's monitoring plan. Switched on per account."
    },
    {
      "name": "Events",
      "description": "The event feed: recent webhook events, for polling (used by the Zapier triggers)."
    }
  ],
  "paths": {
    "/verifications": {
      "post": {
        "tags": [
          "Verifications"
        ],
        "operationId": "createVerification",
        "summary": "Create a verification",
        "description": "Returns a hosted_url to send the investor. Never consumes a seat (a seat is drawn only when the investor completes the flow). If the investor already has a verification in progress with you, that verification is returned. If every earlier one is finished (issued, including expired, or declined or refunded), a new verification is created with `renews` set to the most recent earlier one. Requires a full-access key; a test (sk_test_) key creates a sandbox verification instead. A multi-member entity (entity.structure multi_member, partner billing) is always a new verification: the response lists each owner with their own hosted_url, and the organizer's hosted_url opens the entity hub (entity name and type, entity documents, business check). The CPA reviews the entity once every owner is verified and the entity documents are in; the entity letter can only be signed while every owner's letter is current. A failed multi-member create creates nothing (safe to retry). Optional send_invite: true emails the investor the link for you (partner-paid only); the result is in invite.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 255
            },
            "description": "A retry with the same key and body replays the original 201 (header Idempotency-Replayed: true). Same key with a different body: 409 idempotency_key_reused. Remembered about 24 hours."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateVerificationRequest"
              },
              "examples": {
                "individual": {
                  "value": {
                    "investor": {
                      "email": "jordan@example.com",
                      "first_name": "Jordan",
                      "last_name": "Rivera"
                    },
                    "external_id": "crm-contact-48213",
                    "deal": {
                      "name": "Example Fund II"
                    },
                    "billing": "partner"
                  }
                },
                "joint": {
                  "value": {
                    "investor": {
                      "email": "sam@example.com",
                      "first_name": "Sam",
                      "last_name": "Ortiz"
                    },
                    "type": "joint",
                    "co_investor": {
                      "first_name": "Alex",
                      "last_name": "Ortiz",
                      "relationship": "spouse"
                    }
                  }
                },
                "multi_member": {
                  "value": {
                    "investor": {
                      "email": "organizer@example.com",
                      "first_name": "Dana",
                      "last_name": "Cole"
                    },
                    "type": "entity",
                    "entity": {
                      "name": "Harbor Point Holdings LLC",
                      "type": "llc",
                      "structure": "multi_member"
                    },
                    "owners": [
                      {
                        "first_name": "Dana",
                        "last_name": "Cole",
                        "email": "dana@example.com",
                        "role": "Managing member",
                        "ownership_percent": 50,
                        "external_id": "crm-1001"
                      },
                      {
                        "first_name": "Chris",
                        "last_name": "Lane",
                        "email": "chris@example.com",
                        "ownership_percent": 50
                      }
                    ],
                    "billing": "partner"
                  }
                },
                "sdira": {
                  "value": {
                    "investor": {
                      "email": "lee@example.com",
                      "first_name": "Lee",
                      "last_name": "Park"
                    },
                    "type": "entity",
                    "entity": {
                      "name": "Lee Park IRA",
                      "type": "sdira",
                      "registration": "Example Trust Company FBO Lee Park IRA"
                    },
                    "billing": "partner"
                  }
                },
                "send_invite": {
                  "summary": "We email the investor the link",
                  "value": {
                    "investor": {
                      "email": "jordan@example.com",
                      "first_name": "Jordan",
                      "last_name": "Rivera"
                    },
                    "billing": "partner",
                    "send_invite": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created (or an existing in-progress verification returned).",
            "headers": {
              "Idempotency-Replayed": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                },
                "description": "Present when an idempotent retry replayed the original response."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreatedVerification"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (invalid_request, invalid_external_id, invalid_type, invalid_entity_type, entity_name_required, co_investor_required, co_investor_name_required, co_investor_email_invalid, relationship_invalid, invalid_fund, fund_archived, invalid_hosted_page; for a multi-member entity also invalid_entity_structure, owners_required, invalid_owner_count, invalid_owner, invalid_owner_type, invalid_verification_id, duplicate_owner, owner_name_required, invalid_owner_email, invalid_ownership_percent, owner_not_found, owner_not_individual, owner_not_verified and billing_not_supported). Owner and fund errors name the field in error.param.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "firm_not_verified (live create before your firm's business check passes), terms_not_accepted (live key: your firm has not accepted the current Sponsor Agreement and API Terms on the dashboard; enforced from March 1, 2027), or insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "existing_case_not_joint, idempotency_key_reused or idempotency_in_progress.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (120 requests/min per key). Honor Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "create_failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Verifications"
        ],
        "operationId": "listVerifications",
        "summary": "List your verifications",
        "description": "Newest first. Only ever returns your own verifications. Allowed for status-only keys.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/Status"
            }
          },
          {
            "name": "external_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/ExternalId"
            },
            "description": "Exact, case-sensitive match."
          },
          {
            "name": "fund_id",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^f[0-9a-z]{7}$"
            },
            "description": "Only verifications in this fund (see the fund field). An unknown fund id returns an empty list."
          }
        ],
        "responses": {
          "200": {
            "description": "A page of verifications.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationList"
                }
              }
            }
          },
          "400": {
            "description": "invalid_external_id or invalid_fund (malformed fund_id).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}": {
      "get": {
        "tags": [
          "Verifications"
        ],
        "operationId": "getVerification",
        "summary": "Retrieve a verification",
        "description": "Allowed for status-only keys.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The verification.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Verification"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found (unknown id, or not yours).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}/owners": {
      "post": {
        "tags": [
          "Verifications"
        ],
        "operationId": "addOwner",
        "summary": "Add an owner to a multi-member entity",
        "description": "Only for a multi-member entity created with owners, before its letter is issued. Send one owner (same fields as an owners[] item: first_name, last_name, email, role, ownership_percent, external_id, or verification_id to reuse one of your currently verified individual verifications). A new owner gets their own verification and hosted_url. If the entity was already with the CPA, it waits for the new owner to be verified and the CPA is notified again. Requires a full-access key and a verified firm. Accepts Idempotency-Key (scoped to this entity).",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OwnerInput"
              },
              "examples": {
                "new": {
                  "value": {
                    "first_name": "Robin",
                    "last_name": "Hale",
                    "email": "robin@example.com",
                    "role": "Member",
                    "ownership_percent": 10
                  }
                },
                "reuse": {
                  "value": {
                    "verification_id": "recXXXXXXXXXXXXXX"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Owner added.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "owner",
                    "verification"
                  ],
                  "properties": {
                    "owner": {
                      "$ref": "#/components/schemas/CreatedOwner"
                    },
                    "verification": {
                      "$ref": "#/components/schemas/Verification"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "not_multi_member, owner validation errors (with param), invalid_owner_count, invalid_ownership_percent, duplicate_owner, owner_not_found, owner_not_individual, owner_not_verified.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "firm_not_verified (live key, firm not yet verified), terms_not_accepted (live key: your firm has not accepted the current Sponsor Agreement and API Terms on the dashboard; enforced from March 1, 2027), or insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "entity_issued, entity_closed, entity_busy (retry in a few seconds), idempotency_key_reused or idempotency_in_progress.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "create_failed (nothing was changed).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable or sandbox_unavailable: nothing was changed; retry shortly.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}/owners/{owner_id}": {
      "delete": {
        "tags": [
          "Verifications"
        ],
        "operationId": "removeOwner",
        "summary": "Remove an owner from a multi-member entity",
        "description": "Only before the entity letter is issued, and at least 2 owners must remain (add the replacement first). The owner's own verification is left as it is, and any seat it used stays used. If that owner had not started, their link still works, and completing it later is an ordinary verification (a full seat). If the remaining owners are all verified and the entity documents are in, the entity goes to the CPA. Requires a full-access key.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "owner_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The owner's verification id (owners[].id)."
          }
        ],
        "responses": {
          "200": {
            "description": "Owner removed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "removed",
                    "verification"
                  ],
                  "properties": {
                    "removed": {
                      "type": "string"
                    },
                    "verification": {
                      "$ref": "#/components/schemas/Verification"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "not_multi_member or invalid_owner_count.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found or owner_not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "entity_issued, entity_closed or entity_busy.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "update_failed (nothing was changed).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable or sandbox_unavailable: nothing was changed; retry shortly.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}/letter": {
      "get": {
        "tags": [
          "Verifications"
        ],
        "operationId": "getVerificationLetter",
        "summary": "Download the signed letter",
        "description": "Only when the letter is issued and sharing applies (letter_available is true). Requires a full-access key. The signed URL is short-lived; fetch it when you need it.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "json"
              ]
            },
            "description": "Return the URL as JSON instead of redirecting."
          }
        ],
        "responses": {
          "302": {
            "description": "Redirect to the signed PDF.",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          },
          "200": {
            "description": "With format=json.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id",
                    "letter_url"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "letter_url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found or letter_unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}/photo-id": {
      "post": {
        "tags": [
          "Verifications"
        ],
        "operationId": "addPhotoId",
        "summary": "Send the investor's photo ID",
        "description": "If you already checked the investor's government photo ID, send a copy here so the investor is not asked to upload one. The CPA sees it with the case documents, marked as received from your firm. Send it before the investor submits on the hosted page; after that (or once the verification is finished) it returns 409 case_already_submitted. Sending it again before submission replaces the earlier copy (the earlier files are deleted). If you never send one, the investor uploads their photo ID as usual. For a joint verification this covers the primary investor only; for a multi-member entity send it on each owner's own verification. Retention: the file is never returned by the API. If the verification is issued, it is deleted with the investor's other documents 90 days after the letter is issued. If it is never issued (the investor never submits, the case is refunded or declined, or the investor paid on a separate case), it is deleted 90 days after you sent it. A case the investor has submitted keeps the ID until it is issued or closed, and a case paused with a credit keeps it until the credit expires. Requires a full-access key. Accepts Idempotency-Key (scoped to this verification). Test-mode keys validate the request and record the time but store no file.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PhotoIdInput"
              },
              "examples": {
                "front_only": {
                  "value": {
                    "front": {
                      "filename": "drivers-license.jpg",
                      "content_type": "image/jpeg",
                      "content_base64": "/9j/4AAQSkZJRgABAQ..."
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Photo ID received.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhotoIdReceipt"
                }
              }
            }
          },
          "400": {
            "description": "invalid_request, invalid_photo_id (missing front or bad base64; see param), invalid_photo_id_type (unsupported type, or the file's contents do not match content_type), or not_individual (a multi-member entity).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "method_not_allowed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "case_already_submitted, case_busy (another photo ID for this verification is being saved; retry in a few seconds), idempotency_key_reused or idempotency_in_progress.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "413": {
            "description": "photo_id_too_large: the files together are larger than 3 MB.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "upload_failed or save_failed: nothing was saved; retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable or sandbox_unavailable: nothing was changed; retry shortly.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}/complete": {
      "post": {
        "tags": [
          "Sandbox"
        ],
        "operationId": "completeSandboxVerification",
        "summary": "Sandbox only: simulate issuance",
        "description": "Test keys only. Marks a sandbox verification verified (for a multi-member entity, also its owners) and sends a livemode:false verification.completed webhook to your configured endpoint. Returns 404 for live keys.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The completed sandbox verification.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Verification"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "livemode": {
                          "const": false
                        },
                        "webhook": {
                          "description": "Outcome of the test webhook delivery."
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "sandbox_unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/funds": {
      "get": {
        "tags": [
          "Funds"
        ],
        "operationId": "listFunds",
        "summary": "List your funds",
        "description": "Your firm's funds (the same list as \"Your funds\" on your dashboard), oldest first, archived ones included. Allowed for status-only keys. A test key sees your real funds plus funds it created in the sandbox.",
        "responses": {
          "200": {
            "description": "Your funds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FundList"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Funds"
        ],
        "operationId": "createFund",
        "summary": "Add a fund",
        "description": "Adds a fund to your firm. Safe to retry: if a fund with the same name (case- and space-insensitive) already exists it is returned (200) and (live keys) an archived one is restored. A fund created with a test key exists only in the sandbox. Full-access keys only.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Fund created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fund"
                }
              }
            }
          },
          "200": {
            "description": "A fund with that name already existed (restored if it was archived).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fund"
                }
              }
            }
          },
          "400": {
            "description": "name_required, invalid_request or too_many_funds (50 per firm).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "save_failed: nothing was changed; retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "funds_busy: another fund is being added for your firm; retry in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/screenings": {
      "get": {
        "tags": [
          "Screenings"
        ],
        "operationId": "listScreenings",
        "summary": "List screenings",
        "description": "People your firm added through the API, newest first. Removed people are left out unless you ask for status=removed. Allowed for status-only keys.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "clear",
                "possible_match",
                "under_review",
                "cleared",
                "paused",
                "removed"
              ]
            }
          },
          {
            "name": "external_id",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9._:@-]{1,64}$"
            },
            "description": "Exact, case-sensitive match."
          }
        ],
        "responses": {
          "200": {
            "description": "A page of screenings.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScreeningList"
                }
              }
            }
          },
          "400": {
            "description": "invalid_parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "feature_not_enabled (screening not switched on for your account yet) or insufficient_scope.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Screenings"
        ],
        "operationId": "createScreening",
        "summary": "Screen and monitor people",
        "description": "Send one person, or {\"people\": [...]} with 1-100 people. Each is screened against sanctions and PEP lists within minutes, then monitored; results come back on GET and by webhook. date_of_birth is required. The same name and date of birth already on your list is returned (200), not added twice; a person added on your dashboard is taken over by the API so you can read, remove and get alerts for it. Each person counts toward your monitoring plan for 12 months from when they were added. We screen the details you send; this does not confirm the person's identity. Honors Idempotency-Key. Full-access keys only. A test key returns an instant sandbox result (a name containing \"match\" gives possible_match, \"sanction\" gives under_review) and needs no plan.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/ScreeningInput"
                  },
                  {
                    "type": "object",
                    "required": [
                      "people"
                    ],
                    "properties": {
                      "people": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 100,
                        "items": {
                          "$ref": "#/components/schemas/ScreeningInput"
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Added (one person: the Screening; a batch: the batch result).",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/Screening"
                    },
                    {
                      "$ref": "#/components/schemas/ScreeningBatch"
                    }
                  ]
                }
              }
            }
          },
          "200": {
            "description": "Already on your list (one person), or a batch where nobody new was added.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/Screening"
                    },
                    {
                      "$ref": "#/components/schemas/ScreeningBatch"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "invalid_parameter (param names the field, e.g. date_of_birth) or invalid_request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "no_active_plan: choose a monitoring plan on your dashboard (the free plan covers 5 people).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "plan_limit_reached (one person; the plan is full), busy (another change to your list is saving; retry), or an Idempotency-Key conflict.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "sandbox_unavailable (test keys).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "feature_not_enabled (screening not switched on for your account yet) or insufficient_scope.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "server_error: the person was not added; retry (with the same Idempotency-Key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/screenings/contact": {
      "get": {
        "tags": [
          "Screenings"
        ],
        "operationId": "getMonitoringContact",
        "summary": "Get the monitoring contact",
        "description": "Returns who we email about possible matches on your monitored list, besides your account email. All fields are null when none is set.",
        "responses": {
          "200": {
            "description": "The monitoring contact.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitoringContact"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "feature_not_enabled (screening not switched on for your account) or insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Screenings"
        ],
        "operationId": "setMonitoringContact",
        "summary": "Set the monitoring contact",
        "description": "Replaces the contact. email is required (a missing one returns 400 invalid_parameter, param email); use DELETE to clear the contact. A test key stores it in the sandbox only.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MonitoringContactInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The monitoring contact.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitoringContact"
                }
              }
            }
          },
          "400": {
            "description": "invalid_parameter (param names the bad field: email, phone, cc or name) or invalid_request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "feature_not_enabled (screening not switched on for your account) or insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Screenings"
        ],
        "operationId": "clearMonitoringContact",
        "summary": "Clear the monitoring contact",
        "description": "Alerts then go to your account email only.",
        "responses": {
          "200": {
            "description": "The monitoring contact.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitoringContact"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "feature_not_enabled (screening not switched on for your account) or insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/screenings/{id}": {
      "get": {
        "tags": [
          "Screenings"
        ],
        "operationId": "getScreening",
        "summary": "Get a screening",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^scr_rec[A-Za-z0-9]{14}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The screening.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Screening"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "feature_not_enabled (screening not switched on for your account yet) or insufficient_scope.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Screenings"
        ],
        "operationId": "removeScreening",
        "summary": "Stop monitoring a person",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^scr_rec[A-Za-z0-9]{14}$"
            }
          }
        ],
        "description": "Stops ongoing monitoring and returns the screening with status removed. The person still counts toward your plan for 12 months from when they were added. Full-access keys only. Works even if screening is switched off for your account.",
        "responses": {
          "200": {
            "description": "Removed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Screening"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "feature_not_enabled (screening not switched on for your account yet) or insufficient_scope.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/screenings/{id}/dismiss": {
      "post": {
        "tags": [
          "Screenings"
        ],
        "operationId": "dismissScreeningMatch",
        "summary": "Mark a possible match as a different person",
        "description": "For a PEP, warning or other (non-sanctions) possible match that you have checked. The screening becomes cleared with review.reviewed_by = you, and a screening.reviewed webhook is sent. Not allowed for a possible sanctions-list match: we review those ourselves. A new or different match later reopens it.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^scr_rec[A-Za-z0-9]{14}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "note"
                ],
                "additionalProperties": false,
                "properties": {
                  "note": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 1000,
                    "description": "Why this is a different person (kept with the record)."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The updated screening.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Screening"
                }
              }
            }
          },
          "400": {
            "description": "invalid_parameter (param note) or invalid_request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope (status-only key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "sanctions_match (we review those) or nothing_to_dismiss (no open possible match).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}/reconfirmation-request": {
      "post": {
        "tags": [
          "Verifications"
        ],
        "operationId": "requestReconfirmation",
        "summary": "Ask the investor to re-confirm",
        "description": "Emails the investor a link to re-confirm, in writing, that they still qualify, so you can rely on their earlier CPA verification for a later sale for up to five years (Rule 506(c)(2)(ii)(E); reliance is your decision with counsel). Same as the dashboard button. Free; no new review or letter. Requires an issued letter, a full-access key, a verified firm and current terms. One request per verification every 24 hours. When the investor re-confirms you receive verification.reconfirmed.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional. A retry with the same key returns the first result instead of sending a second email."
          }
        ],
        "responses": {
          "200": {
            "description": "Request emailed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReconfirmationRequest"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope, firm_not_verified or terms_not_accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "not_verified, reconfirmation_window_expired, no_investor_email, reconfirmation_unavailable, connected_verification or reconfirmation_too_soon (error.retry_at says when).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "email_failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/verifications/{id}/request-documents": {
      "post": {
        "tags": [
          "Sandbox"
        ],
        "operationId": "requestDocumentsSandbox",
        "summary": "Sandbox only: simulate a request for more documents",
        "description": "Test keys only. Marks a sandbox verification needs_info and sends a livemode:false verification.needs_info webhook to your configured endpoint. Returns 404 for live keys.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The sandbox verification, now needs_info.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Verification"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "livemode": {
                          "const": false
                        },
                        "webhook": {
                          "description": "Outcome of the test webhook delivery."
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "sandbox_unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "already_verified.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/events": {
      "get": {
        "tags": [
          "Events"
        ],
        "operationId": "listEvents",
        "summary": "List recent events",
        "description": "Your firm's recent events, newest first: the same envelopes the webhook delivers (see Webhooks), kept for 30 days whether or not you set up a webhook. Poll it instead of (or as well as) receiving webhooks; dedupe on id. A live key reads live events; a test key reads sandbox events (from /complete, /request-documents and sandbox screenings). Allowed for status-only keys. Feed for events from 21 Nov 2026 onward.",
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional comma-separated event types, e.g. verification.started,verification.needs_info. Known types: verification.started, verification.needs_info, verification.completed, verification.declined, verification.expired, letter.reissued, verification.reconfirmed, screening.completed, screening.alert, screening.reviewed."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Optional. Only events created after this time."
          }
        ],
        "responses": {
          "200": {
            "description": "Recent events.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventList"
                }
              }
            }
          },
          "400": {
            "description": "invalid_parameter (unknown type, limit out of range, bad since).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "events_unavailable: the feed is temporarily unavailable; retry shortly.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "webhooks": {
    "verification.started": {
      "post": {
        "operationId": "verification_started",
        "summary": "verification.started",
        "description": "The investor submitted for CPA review. No letter yet; certificate_id may be null.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "verification.started"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "verification.started"
                      },
                      "data": {
                        "type": "object",
                        "properties": {
                          "certificate_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^ANV-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}$"
                          },
                          "investor": {
                            "type": "object",
                            "required": [
                              "name",
                              "email",
                              "city",
                              "state",
                              "entity_type",
                              "registration",
                              "co_investor",
                              "type"
                            ],
                            "properties": {
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "email"
                              },
                              "city": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "entity_type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
                              },
                              "registration": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 160,
                                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
                              },
                              "co_investor": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/CoInvestor"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Joint cases only: the second person. Never their email."
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "individual",
                                  "joint",
                                  "entity"
                                ],
                                "description": "Treat an unknown value like individual (values may be added)."
                              }
                            }
                          },
                          "submitted_entity": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/SubmittedEntity"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "external_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "renews": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "id of the earlier verification this one re-verifies."
                          },
                          "deal": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sponsor_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "const": "in_review"
                          },
                          "entity_structure": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "single_owner",
                              "multi_member",
                              "asset_test",
                              null
                            ],
                            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
                          },
                          "owners": {
                            "oneOf": [
                              {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Owner"
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
                          },
                          "requirements": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/Requirements"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
                          },
                          "entity_verification_ids": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
                          },
                          "fund": {
                            "$ref": "#/components/schemas/FundRef"
                          }
                        },
                        "required": [
                          "certificate_id",
                          "status",
                          "investor",
                          "submitted_entity",
                          "external_id",
                          "renews",
                          "deal",
                          "sponsor_slug",
                          "entity_structure",
                          "owners",
                          "requirements",
                          "entity_verification_ids",
                          "fund"
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "verification.needs_info": {
      "post": {
        "operationId": "verification_needs_info",
        "summary": "verification.needs_info",
        "description": "The CPA asked the investor for more documents. Use it to nudge your investor. The CPA's message is not included (it can name documents or figures). status stays in_review. Sent again for each new request (id evt_<certificate_id>.needs_info.<unix ms>).",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "verification.needs_info"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "verification.needs_info"
                      },
                      "data": {
                        "type": "object",
                        "properties": {
                          "certificate_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^ANV-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}$"
                          },
                          "investor": {
                            "type": "object",
                            "required": [
                              "name",
                              "email",
                              "city",
                              "state",
                              "entity_type",
                              "registration",
                              "co_investor",
                              "type"
                            ],
                            "properties": {
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "email"
                              },
                              "city": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "entity_type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
                              },
                              "registration": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 160,
                                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
                              },
                              "co_investor": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/CoInvestor"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Joint cases only: the second person. Never their email."
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "individual",
                                  "joint",
                                  "entity"
                                ],
                                "description": "Treat an unknown value like individual (values may be added)."
                              }
                            }
                          },
                          "submitted_entity": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/SubmittedEntity"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "external_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "renews": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "id of the earlier verification this one re-verifies."
                          },
                          "deal": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sponsor_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "const": "in_review"
                          },
                          "entity_structure": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "single_owner",
                              "multi_member",
                              "asset_test",
                              null
                            ],
                            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
                          },
                          "owners": {
                            "oneOf": [
                              {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Owner"
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
                          },
                          "requirements": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/Requirements"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
                          },
                          "entity_verification_ids": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
                          },
                          "fund": {
                            "$ref": "#/components/schemas/FundRef"
                          },
                          "documents_requested_at": {
                            "type": "string",
                            "format": "date-time",
                            "description": "When the CPA asked for the documents."
                          }
                        },
                        "required": [
                          "certificate_id",
                          "status",
                          "investor",
                          "submitted_entity",
                          "external_id",
                          "renews",
                          "deal",
                          "sponsor_slug",
                          "entity_structure",
                          "owners",
                          "requirements",
                          "entity_verification_ids",
                          "fund",
                          "documents_requested_at"
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "verification.completed": {
      "post": {
        "operationId": "verification_completed",
        "summary": "verification.completed",
        "description": "The CPA signed and the letter is issued. A later CPA re-sign of an issued case sends another verification.completed with a higher revision and id evt_<certificate_id>.completed.r<N>. The event never contains the letter; fetch it from GET /verifications/{id}/letter. It is also sent when an investor connects an existing, current AccreditedNow letter to your firm; those events carry connected: true and the original letter's dates.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "verification.completed"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "verification.completed"
                      },
                      "data": {
                        "type": "object",
                        "properties": {
                          "certificate_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^ANV-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}$"
                          },
                          "investor": {
                            "type": "object",
                            "required": [
                              "name",
                              "email",
                              "city",
                              "state",
                              "entity_type",
                              "registration",
                              "co_investor",
                              "type"
                            ],
                            "properties": {
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "email"
                              },
                              "city": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "entity_type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
                              },
                              "registration": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 160,
                                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
                              },
                              "co_investor": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/CoInvestor"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Joint cases only: the second person. Never their email."
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "individual",
                                  "joint",
                                  "entity"
                                ],
                                "description": "Treat an unknown value like individual (values may be added)."
                              }
                            }
                          },
                          "submitted_entity": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/SubmittedEntity"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "external_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "renews": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "id of the earlier verification this one re-verifies."
                          },
                          "deal": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sponsor_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "const": "verified"
                          },
                          "entity_structure": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "single_owner",
                              "multi_member",
                              "asset_test",
                              null
                            ],
                            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
                          },
                          "owners": {
                            "oneOf": [
                              {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Owner"
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
                          },
                          "requirements": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/Requirements"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
                          },
                          "entity_verification_ids": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
                          },
                          "basis": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "verification_date": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          },
                          "expiration_date": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          },
                          "checks": {
                            "type": "object",
                            "required": [
                              "identity_verified",
                              "sanctions_screened",
                              "business_verified"
                            ],
                            "properties": {
                              "identity_verified": {
                                "type": "boolean",
                                "description": "true when the investor passed the phone ID check (photo of their ID plus a selfie). Joint cases: true only when BOTH people passed it (see investor.co_investor.identity_verified). An uploaded photo ID reviewed by the CPA does not set this."
                              },
                              "sanctions_screened": {
                                "type": "boolean",
                                "description": "true when the sanctions/PEP screen is clear or a potential match was cleared on review."
                              },
                              "business_verified": {
                                "type": "boolean",
                                "description": "Entity cases: registry, good standing and beneficial-owner business check passed."
                              }
                            }
                          },
                          "certificate_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "revision": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "0 for the original letter; higher for each later correction. Always increases; not guaranteed consecutive."
                          },
                          "revised_at": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          },
                          "connected": {
                            "type": "boolean",
                            "description": "Present and true when this verification is one the investor connected (shared an existing AccreditedNow letter with you). Absent otherwise."
                          },
                          "fund": {
                            "$ref": "#/components/schemas/FundRef"
                          }
                        },
                        "required": [
                          "certificate_id",
                          "status",
                          "investor",
                          "submitted_entity",
                          "external_id",
                          "renews",
                          "deal",
                          "sponsor_slug",
                          "entity_structure",
                          "owners",
                          "requirements",
                          "entity_verification_ids",
                          "basis",
                          "verification_date",
                          "expiration_date",
                          "revision",
                          "revised_at",
                          "checks",
                          "certificate_url",
                          "fund"
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "verification.declined": {
      "post": {
        "operationId": "verification_declined",
        "summary": "verification.declined",
        "description": "The CPA declined the case.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "verification.declined"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "verification.declined"
                      },
                      "data": {
                        "type": "object",
                        "properties": {
                          "certificate_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^ANV-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}$"
                          },
                          "investor": {
                            "type": "object",
                            "required": [
                              "name",
                              "email",
                              "city",
                              "state",
                              "entity_type",
                              "registration",
                              "co_investor",
                              "type"
                            ],
                            "properties": {
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "email"
                              },
                              "city": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "entity_type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
                              },
                              "registration": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 160,
                                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
                              },
                              "co_investor": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/CoInvestor"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Joint cases only: the second person. Never their email."
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "individual",
                                  "joint",
                                  "entity"
                                ],
                                "description": "Treat an unknown value like individual (values may be added)."
                              }
                            }
                          },
                          "submitted_entity": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/SubmittedEntity"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "external_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "renews": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "id of the earlier verification this one re-verifies."
                          },
                          "deal": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sponsor_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "const": "declined"
                          },
                          "entity_structure": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "single_owner",
                              "multi_member",
                              "asset_test",
                              null
                            ],
                            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
                          },
                          "owners": {
                            "oneOf": [
                              {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Owner"
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
                          },
                          "requirements": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/Requirements"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
                          },
                          "entity_verification_ids": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
                          },
                          "reason": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "fund": {
                            "$ref": "#/components/schemas/FundRef"
                          }
                        },
                        "required": [
                          "certificate_id",
                          "status",
                          "investor",
                          "submitted_entity",
                          "external_id",
                          "renews",
                          "deal",
                          "sponsor_slug",
                          "entity_structure",
                          "owners",
                          "requirements",
                          "entity_verification_ids",
                          "reason",
                          "fund"
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "verification.expired": {
      "post": {
        "operationId": "verification_expired",
        "summary": "verification.expired",
        "description": "An issued letter passed its expiration date.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "verification.expired"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "verification.expired"
                      },
                      "data": {
                        "type": "object",
                        "properties": {
                          "certificate_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^ANV-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}$"
                          },
                          "investor": {
                            "type": "object",
                            "required": [
                              "name",
                              "email",
                              "city",
                              "state",
                              "entity_type",
                              "registration",
                              "co_investor",
                              "type"
                            ],
                            "properties": {
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "email"
                              },
                              "city": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "entity_type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
                              },
                              "registration": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 160,
                                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
                              },
                              "co_investor": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/CoInvestor"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Joint cases only: the second person. Never their email."
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "individual",
                                  "joint",
                                  "entity"
                                ],
                                "description": "Treat an unknown value like individual (values may be added)."
                              }
                            }
                          },
                          "submitted_entity": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/SubmittedEntity"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "external_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "renews": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "id of the earlier verification this one re-verifies."
                          },
                          "deal": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sponsor_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "const": "expired"
                          },
                          "entity_structure": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "single_owner",
                              "multi_member",
                              "asset_test",
                              null
                            ],
                            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
                          },
                          "owners": {
                            "oneOf": [
                              {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Owner"
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
                          },
                          "requirements": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/Requirements"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
                          },
                          "entity_verification_ids": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
                          },
                          "basis": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "verification_date": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          },
                          "expiration_date": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          },
                          "certificate_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "uri"
                          },
                          "connected": {
                            "type": "boolean",
                            "description": "Present and true when this verification is one the investor connected (shared an existing AccreditedNow letter with you). Absent otherwise."
                          },
                          "fund": {
                            "$ref": "#/components/schemas/FundRef"
                          }
                        },
                        "required": [
                          "certificate_id",
                          "status",
                          "investor",
                          "submitted_entity",
                          "external_id",
                          "renews",
                          "deal",
                          "sponsor_slug",
                          "entity_structure",
                          "owners",
                          "requirements",
                          "entity_verification_ids",
                          "basis",
                          "verification_date",
                          "expiration_date",
                          "certificate_url",
                          "fund"
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "letter.reissued": {
      "post": {
        "operationId": "letter_reissued",
        "summary": "letter.reissued",
        "description": "A corrected copy of an issued letter was delivered to the investor; the verification and its dates are unchanged. Id evt_<certificate_id>.reissued.r<N>. Re-pull the PDF.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "letter.reissued"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "letter.reissued"
                      },
                      "data": {
                        "type": "object",
                        "properties": {
                          "certificate_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^ANV-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}$"
                          },
                          "investor": {
                            "type": "object",
                            "required": [
                              "name",
                              "email",
                              "city",
                              "state",
                              "entity_type",
                              "registration",
                              "co_investor",
                              "type"
                            ],
                            "properties": {
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "email"
                              },
                              "city": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "entity_type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
                              },
                              "registration": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 160,
                                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
                              },
                              "co_investor": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/CoInvestor"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Joint cases only: the second person. Never their email."
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "individual",
                                  "joint",
                                  "entity"
                                ],
                                "description": "Treat an unknown value like individual (values may be added)."
                              }
                            }
                          },
                          "submitted_entity": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/SubmittedEntity"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "external_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "renews": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "id of the earlier verification this one re-verifies."
                          },
                          "deal": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sponsor_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "const": "verified"
                          },
                          "entity_structure": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "single_owner",
                              "multi_member",
                              "asset_test",
                              null
                            ],
                            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
                          },
                          "owners": {
                            "oneOf": [
                              {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Owner"
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
                          },
                          "requirements": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/Requirements"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
                          },
                          "entity_verification_ids": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
                          },
                          "basis": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "verification_date": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          },
                          "expiration_date": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          },
                          "certificate_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "revision": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "0 for the original letter; higher for each later correction. Always increases; not guaranteed consecutive."
                          },
                          "revised_at": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          },
                          "connected": {
                            "type": "boolean",
                            "description": "Present and true when this verification is one the investor connected (shared an existing AccreditedNow letter with you). Absent otherwise."
                          },
                          "fund": {
                            "$ref": "#/components/schemas/FundRef"
                          }
                        },
                        "required": [
                          "certificate_id",
                          "status",
                          "investor",
                          "submitted_entity",
                          "external_id",
                          "renews",
                          "deal",
                          "sponsor_slug",
                          "entity_structure",
                          "owners",
                          "requirements",
                          "entity_verification_ids",
                          "basis",
                          "verification_date",
                          "expiration_date",
                          "revision",
                          "revised_at",
                          "certificate_url",
                          "fund"
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "verification.reconfirmed": {
      "post": {
        "operationId": "verification_reconfirmed",
        "summary": "verification.reconfirmed",
        "description": "The investor gave a written re-confirmation under Rule 506(c)(2)(ii)(E) within five years of verification. No new letter and no date change. Each re-confirmation has its own id evt_<certificate_id>.reconfirmed.<count>. status is \"expired\" when the letter's 90-day validity has passed (usual), otherwise \"verified\". The deal name the investor typed and the representation text are not included.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "verification.reconfirmed"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "verification.reconfirmed"
                      },
                      "data": {
                        "type": "object",
                        "properties": {
                          "certificate_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^ANV-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}$"
                          },
                          "investor": {
                            "type": "object",
                            "required": [
                              "name",
                              "email",
                              "city",
                              "state",
                              "entity_type",
                              "registration",
                              "co_investor",
                              "type"
                            ],
                            "properties": {
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
                              },
                              "email": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "email"
                              },
                              "city": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "entity_type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
                              },
                              "registration": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 160,
                                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
                              },
                              "co_investor": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/CoInvestor"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Joint cases only: the second person. Never their email."
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "individual",
                                  "joint",
                                  "entity"
                                ],
                                "description": "Treat an unknown value like individual (values may be added)."
                              }
                            }
                          },
                          "submitted_entity": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/SubmittedEntity"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "external_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "renews": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "id of the earlier verification this one re-verifies."
                          },
                          "deal": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sponsor_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "verified",
                              "expired"
                            ]
                          },
                          "entity_structure": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "single_owner",
                              "multi_member",
                              "asset_test",
                              null
                            ],
                            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
                          },
                          "owners": {
                            "oneOf": [
                              {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Owner"
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
                          },
                          "requirements": {
                            "oneOf": [
                              {
                                "$ref": "#/components/schemas/Requirements"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
                          },
                          "entity_verification_ids": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
                          },
                          "reconfirmation": {
                            "type": "object",
                            "required": [
                              "reconfirmed_at",
                              "count",
                              "verified_on",
                              "relies_through"
                            ],
                            "properties": {
                              "reconfirmed_at": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "count": {
                                "type": "integer",
                                "minimum": 1
                              },
                              "verified_on": {
                                "type": "string",
                                "format": "date"
                              },
                              "relies_through": {
                                "type": "string",
                                "format": "date",
                                "description": "Five years from verified_on. Whether to rely is the issuer's decision with counsel."
                              }
                            }
                          },
                          "certificate_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "connected": {
                            "type": "boolean",
                            "description": "Present and true when this verification is one the investor connected (shared an existing AccreditedNow letter with you). Absent otherwise."
                          },
                          "fund": {
                            "$ref": "#/components/schemas/FundRef"
                          }
                        },
                        "required": [
                          "certificate_id",
                          "status",
                          "investor",
                          "submitted_entity",
                          "external_id",
                          "renews",
                          "deal",
                          "sponsor_slug",
                          "entity_structure",
                          "owners",
                          "requirements",
                          "entity_verification_ids",
                          "reconfirmation",
                          "certificate_url",
                          "fund"
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "screening.completed": {
      "post": {
        "operationId": "screening_completed",
        "summary": "screening.completed",
        "description": "The first result for a person added through /v1/screenings is in. data is the Screening plus sponsor_slug. Event id: evt_<screening id>.completed.<n> for the first result (n is the screening time in milliseconds, so a re-screen gets a new id); evt_<screening id>.alert.<n> for each alert.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "screening.completed"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "screening.completed"
                      },
                      "data": {
                        "allOf": [
                          {
                            "$ref": "#/components/schemas/Screening"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "sponsor_slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "screening.alert": {
      "post": {
        "operationId": "screening_alert",
        "summary": "screening.alert",
        "description": "Ongoing monitoring found a new or changed match for a screened person. data is the Screening as it is now, plus sponsor_slug. Event id: evt_<screening id>.completed for the first result; evt_<screening id>.alert.<n> for each alert.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "screening.alert"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "screening.alert"
                      },
                      "data": {
                        "allOf": [
                          {
                            "$ref": "#/components/schemas/Screening"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "sponsor_slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    },
    "screening.reviewed": {
      "post": {
        "operationId": "screening_reviewed",
        "summary": "screening.reviewed",
        "description": "A possible match was reviewed: by us (a possible sanctions-list match) or by you (POST /v1/screenings/{id}/dismiss). data is the Screening as it is now, with review filled in, plus sponsor_slug. Event id: evt_<screening id>.reviewed.<n>. Sent only for people added through the API.",
        "parameters": [
          {
            "name": "X-AccreditedNow-Event",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "const": "screening.reviewed"
            }
          },
          {
            "name": "X-AccreditedNow-Delivery",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Same as the envelope id. Dedupe on it."
          },
          {
            "name": "X-AccreditedNow-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "event": {
                        "const": "screening.reviewed"
                      },
                      "data": {
                        "allOf": [
                          {
                            "$ref": "#/components/schemas/Screening"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "sponsor_slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Acknowledge within a few seconds. Anything else (or a timeout) is retried a bounded number of times."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "sk_live_... or sk_test_... from the sponsor dashboard. Server-side only. Keys are full access or status only (status-only keys may only list and retrieve)."
      }
    },
    "schemas": {
      "Status": {
        "type": "string",
        "enum": [
          "created",
          "in_review",
          "verified",
          "expired",
          "declined",
          "refunded"
        ]
      },
      "ExternalId": {
        "type": "string",
        "pattern": "^[A-Za-z0-9._:@-]{1,100}$"
      },
      "CoInvestor": {
        "type": "object",
        "required": [
          "name",
          "relationship"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "relationship": {
            "type": "string",
            "enum": [
              "spouse",
              "spousal_equivalent"
            ]
          },
          "identity_verified": {
            "type": "boolean",
            "description": "true when this second person passed their own phone ID check (photo of their ID plus a selfie). false when they were identified by an uploaded photo ID that the CPA reviewed, or have not finished yet."
          }
        }
      },
      "SubmittedEntity": {
        "type": "object",
        "description": "What you sent on create (never printed or screened as sent). Cleared 90 days after the letter is issued.",
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Readable label, e.g. \"LLC\", \"Self-Directed IRA\"."
          },
          "registration": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "message"
            ],
            "properties": {
              "type": {
                "type": "string",
                "examples": [
                  "unauthorized",
                  "insufficient_scope",
                  "firm_not_verified",
                  "terms_not_accepted",
                  "not_found",
                  "letter_unavailable",
                  "method_not_allowed",
                  "invalid_request",
                  "invalid_external_id",
                  "invalid_type",
                  "invalid_entity_type",
                  "entity_name_required",
                  "co_investor_required",
                  "co_investor_name_required",
                  "co_investor_email_invalid",
                  "relationship_invalid",
                  "existing_case_not_joint",
                  "idempotency_key_reused",
                  "idempotency_in_progress",
                  "rate_limited",
                  "server_error",
                  "create_failed",
                  "sandbox_unavailable",
                  "invalid_entity_structure",
                  "owners_required",
                  "invalid_owner_count",
                  "invalid_owner",
                  "invalid_owner_type",
                  "invalid_verification_id",
                  "duplicate_owner",
                  "owner_name_required",
                  "invalid_owner_email",
                  "invalid_ownership_percent",
                  "billing_not_supported",
                  "owner_not_found",
                  "owner_not_individual",
                  "owner_not_verified",
                  "not_multi_member",
                  "entity_issued",
                  "entity_closed",
                  "entity_busy",
                  "update_failed",
                  "temporarily_unavailable",
                  "feature_not_enabled",
                  "no_active_plan",
                  "plan_limit_reached",
                  "busy",
                  "invalid_parameter",
                  "not_verified",
                  "reconfirmation_window_expired",
                  "no_investor_email",
                  "reconfirmation_unavailable",
                  "connected_verification",
                  "reconfirmation_too_soon",
                  "email_failed",
                  "already_verified"
                ]
              },
              "message": {
                "type": "string"
              },
              "param": {
                "type": "string",
                "description": "The request field the error is about, when there is one, e.g. owners[2].email."
              },
              "retry_at": {
                "type": "string",
                "format": "date-time",
                "description": "reconfirmation_too_soon: when the next request may be sent."
              },
              "relies_through": {
                "type": "string",
                "format": "date",
                "description": "reconfirmation errors: the last day of the re-reliance window."
              }
            }
          }
        }
      },
      "CreateVerificationRequest": {
        "type": "object",
        "required": [
          "investor"
        ],
        "properties": {
          "investor": {
            "type": "object",
            "required": [
              "email"
            ],
            "properties": {
              "email": {
                "type": "string",
                "format": "email"
              },
              "first_name": {
                "type": "string",
                "description": "Longer than 60 characters is truncated, not rejected."
              },
              "last_name": {
                "type": "string",
                "description": "Longer than 60 characters is truncated, not rejected."
              },
              "date_of_birth": {
                "type": "string",
                "format": "date",
                "description": "Optional. Used only to sharpen the sanctions screen; never returned or printed. Checked against the investor's photo ID: if they differ, the screen runs on name alone."
              },
              "nationality": {
                "type": "string",
                "pattern": "^[A-Za-z]{2}$",
                "description": "Optional ISO 3166-1 alpha-2. Screening only; never returned."
              },
              "phone": {
                "type": "string",
                "description": "Optional. 10 to 15 digits; a leading + and spaces, dashes, dots and parentheses are allowed. Streamlined hosted page: the investor is not asked for it (we may text them about the verification at this number). A malformed value is ignored."
              },
              "city": {
                "type": "string",
                "description": "Optional. City printed on the letter (2 to 60 characters). Streamlined hosted page: not asked again. A malformed value is ignored."
              },
              "state": {
                "type": "string",
                "description": "Optional. US state as a two-letter code (e.g. \"CA\") or full name; DC and PR are accepted. Printed on the letter. Streamlined hosted page: not asked again. An unknown value is ignored."
              },
              "home_street": {
                "type": "string",
                "description": "Optional. Street line of the investor's home (primary residence), e.g. \"12 Oak Lane\" (3 to 120 characters). Streamlined hosted page: fills the net-worth home-address question, shown to the investor under what's on file with an Edit button; the home is assumed to be in investor.city and investor.state. Never printed on the letter or returned. A malformed value is ignored."
              }
            }
          },
          "type": {
            "type": "string",
            "enum": [
              "individual",
              "joint",
              "entity"
            ],
            "default": "individual",
            "description": "Sending entity without type implies entity."
          },
          "entity": {
            "type": "object",
            "description": "type entity only. Pre-fills the investor's entity fields in the seat-covered flow; what the investor confirms is what the CPA reviews and prints.",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Longer than 160 characters is truncated."
              },
              "type": {
                "type": "string",
                "enum": [
                  "llc",
                  "lp",
                  "corporation",
                  "trust",
                  "sdira",
                  "other"
                ],
                "description": "sdira = a self-directed IRA. It is verified through its one owner, priced like an individual verification (one seat on billing partner), has no business check, and cannot be multi_member."
              },
              "registration": {
                "type": "string",
                "description": "How the investment is titled, e.g. a custodian FBO line. Must be a string; longer than 160 characters is truncated."
              },
              "structure": {
                "type": "string",
                "enum": [
                  "single_owner",
                  "multi_member"
                ],
                "description": "multi_member: an entity whose owners are each verified (look-through). Requires owners[] and billing partner. Implies type entity. Not allowed when type is sdira (400 invalid_entity_structure)."
              }
            }
          },
          "co_investor": {
            "type": "object",
            "description": "type joint only.",
            "required": [
              "first_name",
              "last_name"
            ],
            "properties": {
              "first_name": {
                "type": "string"
              },
              "last_name": {
                "type": "string"
              },
              "email": {
                "type": "string",
                "format": "email"
              },
              "relationship": {
                "type": "string",
                "enum": [
                  "spouse",
                  "spousal_equivalent"
                ],
                "default": "spouse"
              }
            }
          },
          "relationship": {
            "type": "string",
            "enum": [
              "spouse",
              "spousal_equivalent"
            ],
            "description": "Joint only; alternative to co_investor.relationship."
          },
          "external_id": {
            "$ref": "#/components/schemas/ExternalId"
          },
          "deal": {
            "description": "Deal or fund name; longer than 140 characters is truncated.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  }
                }
              }
            ]
          },
          "billing": {
            "type": "string",
            "enum": [
              "partner",
              "investor"
            ],
            "description": "partner: a seat covers it. investor: the investor pays at checkout. The hosted_url opens our start page with the investor's email (and, for joint, the co-investor) prefilled; a self-directed IRA link preselects the IRA option, and for a single-owner or asset-test entity the investor chooses the entity option there (submitted entity details are not prefilled on that page). The paid case is linked back to this verification. Defaults to the key's setting, chosen when the key is generated (the dashboard suggests partner when your firm has seats or a card on file, otherwise investor). A multi-member entity is partner only (billing_not_supported)."
          },
          "owners": {
            "type": "array",
            "minItems": 2,
            "maxItems": 30,
            "items": {
              "$ref": "#/components/schemas/OwnerInput"
            },
            "description": "Required when entity.structure is multi_member, otherwise not allowed. Each owner becomes (or, with verification_id, reuses) their own individual verification. ownership_percent values may not add up to more than 100."
          },
          "fund_id": {
            "type": "string",
            "pattern": "^[Ff][0-9A-Za-z]{7}$",
            "description": "Optional. One of your funds (GET /v1/funds). Files the verification under that fund on your dashboard, compliance packet and API. Must not be archived. On an existing in-progress verification for the same investor, the newest fund_id wins. If the investor's in-progress verification is already filed under another firm's fund, it is left there and fund is null in the response."
          },
          "qualification": {
            "type": "string",
            "enum": [
              "income",
              "net_worth",
              "license"
            ],
            "description": "Optional. How the investor expects to qualify. Streamlined hosted page: preselects the matching document checklist (the investor can still change it). The CPA decides from the documents. An unknown value is ignored."
          },
          "hosted_page": {
            "type": "string",
            "enum": [
              "streamlined",
              "standard"
            ],
            "description": "Optional. Partner-paid links only. Without it, the hosted page is streamlined when you send any of investor.phone, investor.city, investor.state, investor.home_street or qualification: those fields (and the name and email) are filled in and not shown, leaving the documents, photo ID and the confirmation box. \"standard\" always shows the full page; \"streamlined\" uses it even when you send only name and email. Any other value is 400 invalid_hosted_page."
          },
          "send_invite": {
            "type": "boolean",
            "description": "Optional. true = we email the investor hosted_url for you (the same invite the dashboard sends, with up to two automatic reminders if they don't start). Partner-paid single verifications only (billing investor or a multi-member entity is refused with send_invite_unavailable). At most one invite per investor every 24 hours, and a daily cap per firm. The create never fails because of the invite: see invite in the response."
          }
        }
      },
      "CreatedVerification": {
        "type": "object",
        "required": [
          "id",
          "object",
          "status",
          "billing",
          "type",
          "external_id",
          "renews",
          "submitted_entity",
          "hosted_url",
          "fund"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "verification"
          },
          "status": {
            "type": "string",
            "description": "Always \"created\" on this response, even when an existing in-progress verification is returned. Read the real status with GET /verifications/{id}."
          },
          "billing": {
            "type": "string",
            "enum": [
              "partner",
              "investor"
            ]
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "renews": {
            "type": [
              "string",
              "null"
            ]
          },
          "co_investor": {
            "$ref": "#/components/schemas/CoInvestor"
          },
          "submitted_entity": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/SubmittedEntity"
              },
              {
                "type": "null"
              }
            ]
          },
          "hosted_url": {
            "type": "string",
            "format": "uri",
            "description": "Send this to the investor. Usually carries an invite code (inv=) that ties their submission to this id even if they use a different email; it grants no access by itself. It is omitted when the returned verification already has a submission in progress, in which case the case is matched by email."
          },
          "entity_structure": {
            "type": "string",
            "enum": [
              "multi_member"
            ],
            "description": "Multi-member create only."
          },
          "owners": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreatedOwner"
            },
            "description": "Multi-member create only, in the order sent. Send each owner their hosted_url."
          },
          "livemode": {
            "type": "boolean",
            "description": "Sandbox only (false)."
          },
          "test_complete_url": {
            "type": "string",
            "format": "uri",
            "description": "Sandbox only."
          },
          "note": {
            "type": "string",
            "description": "Sandbox only."
          },
          "fund": {
            "$ref": "#/components/schemas/FundRef"
          },
          "hosted_page": {
            "type": "string",
            "enum": [
              "streamlined",
              "standard"
            ],
            "description": "Which hosted page hosted_url opens. Streamlined applies to partner-paid links only; billing investor is always standard."
          },
          "invite": {
            "$ref": "#/components/schemas/InviteResult",
            "description": "Present only when the request included send_invite."
          }
        }
      },
      "Verification": {
        "type": "object",
        "required": [
          "id",
          "object",
          "status",
          "type",
          "investor",
          "submitted_entity",
          "external_id",
          "basis",
          "verification_date",
          "expiration_date",
          "certificate_id",
          "certificate_url",
          "checks",
          "deal",
          "letter_available",
          "created",
          "renews",
          "renewed_by",
          "connected",
          "fund"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "verification"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "type": {
            "type": "string",
            "enum": [
              "individual",
              "joint",
              "entity"
            ],
            "description": "Treat an unknown value like individual."
          },
          "investor": {
            "type": "object",
            "required": [
              "name",
              "email",
              "city",
              "state",
              "entity_type",
              "registration",
              "co_investor"
            ],
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Investor's name as confirmed in the hosted flow (the entity's name for an entity case)."
              },
              "email": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "email"
              },
              "city": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "state": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entity_type": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Investor-confirmed entity type label, e.g. \"LLC\", \"Trust\", \"Self-Directed IRA\"; null for individual and joint cases."
              },
              "registration": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 160,
                "description": "Investor-confirmed registration line as printed on the letter (e.g. a custodian FBO line), or null."
              },
              "co_investor": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/CoInvestor"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Joint cases only: the second person. Never their email."
              }
            }
          },
          "submitted_entity": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/SubmittedEntity"
              },
              {
                "type": "null"
              }
            ]
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "basis": {
            "type": [
              "string",
              "null"
            ],
            "description": "e.g. \"Income\", \"Net Worth\"."
          },
          "verification_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "expiration_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "certificate_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Assigned when the case goes to CPA review; printed on the letter."
          },
          "certificate_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "checks": {
            "type": "object",
            "required": [
              "identity_verified",
              "sanctions_screened",
              "business_verified"
            ],
            "properties": {
              "identity_verified": {
                "type": "boolean",
                "description": "true when the investor passed the phone ID check (photo of their ID plus a selfie). Joint cases: true only when BOTH people passed it (see investor.co_investor.identity_verified). An uploaded photo ID reviewed by the CPA does not set this."
              },
              "sanctions_screened": {
                "type": "boolean",
                "description": "true when the sanctions/PEP screen is clear or a potential match was cleared on review."
              },
              "business_verified": {
                "type": "boolean",
                "description": "Entity cases: registry, good standing and beneficial-owner business check passed."
              }
            }
          },
          "deal": {
            "type": [
              "string",
              "null"
            ]
          },
          "letter_available": {
            "type": "boolean",
            "description": "A signed letter exists and sharing applies."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the case was submitted for review (a date, YYYY-MM-DD, for live cases; an ISO timestamp in the sandbox), or null before submission."
          },
          "renews": {
            "type": [
              "string",
              "null"
            ]
          },
          "renewed_by": {
            "type": [
              "string",
              "null"
            ]
          },
          "entity_structure": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "single_owner",
              "multi_member",
              "asset_test",
              null
            ],
            "description": "Entity cases: how the entity qualifies. null for individual and joint cases, and for quoted family-office or institutional cases. Treat an unknown value as an entity you don't specially handle."
          },
          "owners": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Owner"
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Multi-member entities created with owners[]: each owner's own verification. null otherwise."
          },
          "requirements": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Requirements"
              },
              {
                "type": "null"
              }
            ],
            "description": "Multi-member entities created with owners[]: what is still needed before the CPA reviews the entity. null otherwise."
          },
          "entity_verification_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The multi-member entity verifications this verification is an owner of (empty for most)."
          },
          "connected": {
            "type": "boolean",
            "description": "true when the investor shared an existing, current AccreditedNow verification with you (free) instead of verifying again. Dates, certificate and letter are the original verification's; the letter is shared because the investor consented when connecting it."
          },
          "fund": {
            "$ref": "#/components/schemas/FundRef"
          },
          "needs_info": {
            "type": "boolean",
            "description": "true while the CPA has asked the investor for more documents and is waiting for them (status stays in_review). Goes back to false when the investor submits again."
          },
          "documents_requested_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When the CPA last asked the investor for more documents, or null if never."
          },
          "reconfirmation": {
            "$ref": "#/components/schemas/Reconfirmation"
          }
        }
      },
      "OwnerInput": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "individual"
            ],
            "default": "individual",
            "description": "An owner that is itself an entity is not supported yet."
          },
          "first_name": {
            "type": "string"
          },
          "last_name": {
            "type": "string"
          },
          "email": {
            "type": "string",
            "format": "email",
            "description": "Required unless verification_id is sent. Each owner needs their own email."
          },
          "role": {
            "type": "string",
            "maxLength": 60
          },
          "ownership_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "external_id": {
            "$ref": "#/components/schemas/ExternalId"
          },
          "verification_id": {
            "type": "string",
            "description": "Reuse one of your existing verifications that is currently verified (issued and unexpired). Name and email may then be omitted."
          }
        }
      },
      "Owner": {
        "type": "object",
        "required": [
          "id",
          "external_id",
          "name",
          "email",
          "role",
          "ownership_percent",
          "status",
          "reused",
          "verification_date",
          "expiration_date",
          "latest_verification_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The owner's own verification id (GET /verifications/{id})."
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ],
            "format": "email"
          },
          "role": {
            "type": [
              "string",
              "null"
            ]
          },
          "ownership_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "reused": {
            "type": "boolean"
          },
          "verification_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "expiration_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "latest_verification_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "When this owner re-verified (or paid through a separate case), the id of the newer verification that now counts for the entity; status and dates are read from it. null when the original verification still counts."
          }
        }
      },
      "CreatedOwner": {
        "type": "object",
        "required": [
          "id",
          "object",
          "external_id",
          "name",
          "email",
          "role",
          "ownership_percent",
          "status",
          "reused",
          "hosted_url"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "verification"
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ],
            "format": "email"
          },
          "role": {
            "type": [
              "string",
              "null"
            ]
          },
          "ownership_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "reused": {
            "type": "boolean"
          },
          "hosted_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "The owner's own verification link; null for a reused owner."
          }
        }
      },
      "Requirements": {
        "type": "object",
        "required": [
          "owners_pending",
          "entity_documents",
          "business_check"
        ],
        "properties": {
          "owners_pending": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Owner verification ids not yet currently verified (issued and unexpired)."
          },
          "entity_documents": {
            "type": "boolean",
            "description": "The organizer has uploaded the entity's documents."
          },
          "business_check": {
            "type": "string",
            "enum": [
              "not_requested",
              "not_started",
              "pending",
              "in_review",
              "verified",
              "failed"
            ],
            "description": "The included business (KYB) check on the entity. Treat an unknown value as pending."
          }
        }
      },
      "VerificationList": {
        "type": "object",
        "required": [
          "object",
          "data",
          "total",
          "limit",
          "offset",
          "has_more"
        ],
        "properties": {
          "object": {
            "const": "list"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Verification"
            }
          },
          "total": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          }
        }
      },
      "EventEnvelope": {
        "type": "object",
        "required": [
          "id",
          "event",
          "version",
          "livemode",
          "created",
          "data"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "evt_<certificate_id>.<event> (screenings: evt_<screening id>.<event>), plus .r<N> for a correction or .<N> for a repeatable event. Stable across retries; dedupe on it."
          },
          "event": {
            "type": "string"
          },
          "version": {
            "type": "string",
            "const": "2026-08-18"
          },
          "livemode": {
            "type": "boolean",
            "description": "true for live events; false for dashboard test sends and for events fired by the sandbox /complete action."
          },
          "created": {
            "type": "string",
            "format": "date-time"
          },
          "data": {
            "type": "object"
          }
        }
      },
      "FundRef": {
        "type": [
          "object",
          "null"
        ],
        "description": "The fund this verification belongs to under your firm, or null. A verification belongs to a fund when it was created with fund_id, tagged on your dashboard, or started from a fund link; otherwise when its deal name equals a fund's name (case- and space-insensitive). Grouping only: never printed on the letter.",
        "required": [
          "id",
          "name"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^f[0-9a-z]{7}$"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "Fund": {
        "type": "object",
        "required": [
          "id",
          "object",
          "name",
          "archived",
          "created"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^f[0-9a-z]{7}$"
          },
          "object": {
            "const": "fund"
          },
          "name": {
            "type": "string",
            "maxLength": 120
          },
          "archived": {
            "type": "boolean",
            "description": "Archived funds still group their existing verifications but cannot be used as fund_id on a new one."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "livemode": {
            "type": "boolean",
            "description": "Present (false) only on a fund created with a test key; it exists only in the sandbox."
          }
        }
      },
      "FundList": {
        "type": "object",
        "required": [
          "object",
          "data"
        ],
        "properties": {
          "object": {
            "const": "list"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Fund"
            }
          }
        }
      },
      "ScreeningMatch": {
        "type": "object",
        "required": [
          "name",
          "lists",
          "category"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "The listed name that matched."
          },
          "lists": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 3
          },
          "category": {
            "type": "string",
            "enum": [
              "sanction",
              "pep",
              "warning",
              "other"
            ]
          }
        }
      },
      "ScreeningInput": {
        "type": "object",
        "required": [
          "date_of_birth"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 120,
            "description": "Full name. Or send first_name and last_name."
          },
          "first_name": {
            "type": "string",
            "maxLength": 60
          },
          "last_name": {
            "type": "string",
            "maxLength": 60
          },
          "date_of_birth": {
            "type": "string",
            "format": "date",
            "description": "Required. YYYY-MM-DD, a real past date. It cuts false matches on common names."
          },
          "nationality": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "ISO 3166-1 alpha-2 country code. country is accepted as an alias."
          },
          "external_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9._:@-]{1,64}$",
            "description": "Your own id for this person; returned on every read and webhook."
          },
          "email": {
            "type": "string",
            "format": "email",
            "description": "Optional. Never used to contact the person."
          }
        }
      },
      "Screening": {
        "type": "object",
        "required": [
          "id",
          "object",
          "status",
          "name",
          "matches",
          "monitoring",
          "livemode"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^scr_rec[A-Za-z0-9]{14}$"
          },
          "object": {
            "type": "string",
            "const": "screening"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "clear",
              "possible_match",
              "under_review",
              "cleared",
              "paused",
              "removed"
            ],
            "description": "pending: queued, usually done within minutes. clear: no match. possible_match: a PEP, warning or other match for you to review. under_review: a possible sanctions-list match; we review it ourselves (if we cannot rule it out it stays under_review with review.outcome possible_same_person). cleared: we reviewed a match and found it is a different person. paused: your plan is not active, so monitoring is paused. removed: you stopped monitoring. A cleared status also comes from you marking a PEP or watch-list match as a different person (POST /v1/screenings/{id}/dismiss); see review.reviewed_by."
          },
          "name": {
            "type": "string"
          },
          "date_of_birth": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "nationality": {
            "type": [
              "string",
              "null"
            ]
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "matches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScreeningMatch"
            },
            "description": "Empty unless the status is possible_match, under_review or cleared."
          },
          "monitoring": {
            "type": "boolean",
            "description": "true while ongoing monitoring is running for this person."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "screened_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "removed_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "review": {
            "$ref": "#/components/schemas/ScreeningReview"
          },
          "livemode": {
            "type": "boolean"
          }
        }
      },
      "ScreeningBatchResult": {
        "type": "object",
        "required": [
          "index",
          "status"
        ],
        "properties": {
          "index": {
            "type": "integer",
            "description": "Position in your people array."
          },
          "status": {
            "type": "string",
            "enum": [
              "created",
              "existing",
              "error"
            ]
          },
          "screening": {
            "$ref": "#/components/schemas/Screening"
          },
          "error": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "param": {
                "type": "string"
              }
            }
          }
        }
      },
      "ScreeningBatch": {
        "type": "object",
        "required": [
          "object",
          "created",
          "existing",
          "errors",
          "results"
        ],
        "properties": {
          "object": {
            "type": "string",
            "const": "batch"
          },
          "created": {
            "type": "integer"
          },
          "existing": {
            "type": "integer"
          },
          "errors": {
            "type": "integer"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScreeningBatchResult"
            }
          },
          "on_list": {
            "type": "integer",
            "description": "People now counted toward your plan (live keys)."
          },
          "plan_limit": {
            "type": "integer"
          },
          "livemode": {
            "type": "boolean"
          }
        }
      },
      "ScreeningList": {
        "type": "object",
        "required": [
          "object",
          "data",
          "total",
          "limit",
          "offset",
          "has_more"
        ],
        "properties": {
          "object": {
            "type": "string",
            "const": "list"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Screening"
            }
          },
          "total": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          }
        }
      },
      "MonitoringContact": {
        "type": "object",
        "description": "Who we email about possible matches on your monitored list, in addition to your account email. Possible sanctions-list matches always reach them.",
        "properties": {
          "object": {
            "type": "string",
            "enum": [
              "monitoring_contact"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ],
            "format": "email"
          },
          "phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "cc": {
            "type": "array",
            "maxItems": 2,
            "items": {
              "type": "string",
              "format": "email"
            },
            "description": "Up to 2 more addresses that get a copy."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "livemode": {
            "type": "boolean"
          }
        },
        "required": [
          "object",
          "name",
          "email",
          "phone",
          "cc",
          "updated",
          "livemode"
        ]
      },
      "MonitoringContactInput": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 120
          },
          "email": {
            "type": "string",
            "format": "email",
            "description": "Required."
          },
          "phone": {
            "type": "string",
            "maxLength": 40
          },
          "cc": {
            "type": "array",
            "maxItems": 2,
            "items": {
              "type": "string",
              "format": "email"
            }
          }
        },
        "required": [
          "email"
        ]
      },
      "ScreeningReview": {
        "type": [
          "object",
          "null"
        ],
        "description": "The outcome of a review of a possible match, or null until one is recorded.",
        "required": [
          "outcome",
          "note",
          "reviewed_by",
          "reviewed_at"
        ],
        "properties": {
          "outcome": {
            "type": "string",
            "enum": [
              "different_person",
              "possible_same_person"
            ],
            "description": "different_person: the listed person is not your investor. possible_same_person: we could not rule it out (only from our review of a sanctions-list match); do not pay the investor before speaking to your counsel."
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          },
          "reviewed_by": {
            "type": "string",
            "enum": [
              "accreditednow",
              "you"
            ]
          },
          "reviewed_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "PhotoIdFile": {
        "type": "object",
        "required": [
          "content_type",
          "content_base64"
        ],
        "additionalProperties": false,
        "properties": {
          "filename": {
            "type": "string",
            "maxLength": 80,
            "description": "Optional file name, e.g. passport. Characters other than letters, digits, spaces and . ( ) - are dropped, and the extension is always set from content_type."
          },
          "content_type": {
            "type": "string",
            "enum": [
              "image/jpeg",
              "image/jpg",
              "image/png",
              "image/heic",
              "image/heif",
              "image/webp",
              "application/pdf"
            ],
            "description": "Must match the file's contents (checked from its first bytes), else 400 invalid_photo_id_type."
          },
          "content_base64": {
            "type": "string",
            "description": "The file, base64-encoded. A data: URL prefix is accepted."
          }
        }
      },
      "PhotoIdInput": {
        "type": "object",
        "required": [
          "front"
        ],
        "properties": {
          "front": {
            "$ref": "#/components/schemas/PhotoIdFile"
          },
          "back": {
            "$ref": "#/components/schemas/PhotoIdFile"
          }
        },
        "description": "The front of the government photo ID (required) and the back (optional). Both files together must be 3 MB or less (the whole request body must stay under 4.5 MB, so do not pad it)."
      },
      "PhotoIdReceipt": {
        "type": "object",
        "required": [
          "id",
          "object",
          "photo_id_received",
          "files",
          "received_at"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "type": "string",
            "const": "photo_id"
          },
          "photo_id_received": {
            "type": "boolean",
            "const": true
          },
          "files": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2
          },
          "received_at": {
            "type": "string",
            "format": "date-time"
          },
          "livemode": {
            "type": "boolean",
            "description": "Present (false) only for test-mode keys."
          }
        }
      },
      "Reconfirmation": {
        "type": [
          "object",
          "null"
        ],
        "description": "Five-year re-reliance window (Rule 506(c)(2)(ii)(E)). null until a letter is issued, and on refunded, declined or connected verifications.",
        "properties": {
          "relies_through": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Last day the issuer may rely on this verification with a written re-confirmation (verification date + 5 years)."
          },
          "last_requested_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When a re-confirmation request was last emailed to the investor (from the API or your dashboard)."
          },
          "last_reconfirmed_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When the investor last re-confirmed in writing."
          },
          "count": {
            "type": "integer",
            "minimum": 0,
            "description": "How many written re-confirmations are on file."
          }
        },
        "required": [
          "relies_through",
          "last_requested_at",
          "last_reconfirmed_at",
          "count"
        ]
      },
      "ReconfirmationRequest": {
        "type": "object",
        "required": [
          "object",
          "verification_id",
          "sent_to",
          "requested_at",
          "relies_through",
          "livemode"
        ],
        "properties": {
          "object": {
            "const": "reconfirmation_request"
          },
          "verification_id": {
            "type": "string"
          },
          "sent_to": {
            "type": "string",
            "description": "The investor email the request went to."
          },
          "requested_at": {
            "type": "string",
            "format": "date-time"
          },
          "relies_through": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "livemode": {
            "type": "boolean",
            "description": "false for test keys (no email is sent and there is no 24-hour limit)."
          }
        }
      },
      "InviteResult": {
        "type": "object",
        "required": [
          "sent",
          "reason",
          "sent_at"
        ],
        "properties": {
          "sent": {
            "type": "boolean",
            "description": "true when the invite email went out."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              null,
              "not_requested",
              "already_started",
              "unsubscribed",
              "recently_sent",
              "no_seats",
              "daily_limit",
              "send_failed",
              "test_mode"
            ],
            "description": "Why it was not sent (null when sent). not_requested: send_invite was false. already_started: the investor already started this verification. unsubscribed: they opted out of our emails. recently_sent: an invite went in the last 24 hours. no_seats: your firm has no seats and no card on file, so the link would not work yet. daily_limit: your firm reached today's invite limit. send_failed: the email could not be sent; send hosted_url yourself. test_mode: test keys (and our own test addresses) never send email."
          },
          "sent_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        }
      },
      "EventList": {
        "type": "object",
        "required": [
          "object",
          "data",
          "livemode"
        ],
        "properties": {
          "object": {
            "type": "string",
            "const": "list"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EventEnvelope"
            },
            "description": "Newest first."
          },
          "livemode": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
