{
  "asyncapi": "3.0.0",
  "id": "https://accreditednow.org/asyncapi-v1.json",
  "info": {
    "title": "AccreditedNow Verification API webhooks",
    "version": "1.0.0",
    "description": "Signed webhook events AccreditedNow sends to a sponsor or platform endpoint as a verification moves through its lifecycle. Every request carries X-AccreditedNow-Signature: t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>. Dedupe on the envelope id. Generated from https://accreditednow.org/openapi-v1.json (the webhooks section), which is the source of truth. Guide: https://accreditednow.org/verification-api#webhook",
    "contact": {
      "name": "AccreditedNow",
      "url": "https://accreditednow.org/contact"
    },
    "externalDocs": {
      "url": "https://accreditednow.org/verification-api#webhook"
    }
  },
  "defaultContentType": "application/json",
  "servers": {
    "yourEndpoint": {
      "host": "your-endpoint.example.com",
      "protocol": "https",
      "description": "Your own HTTPS endpoint, set as the webhook URL in your sponsor dashboard."
    }
  },
  "channels": {
    "verification_started": {
      "address": null,
      "title": "verification.started",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "verification_started": {
          "$ref": "#/components/messages/verification_started"
        }
      }
    },
    "verification_needs_info": {
      "address": null,
      "title": "verification.needs_info",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "verification_needs_info": {
          "$ref": "#/components/messages/verification_needs_info"
        }
      }
    },
    "verification_completed": {
      "address": null,
      "title": "verification.completed",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "verification_completed": {
          "$ref": "#/components/messages/verification_completed"
        }
      }
    },
    "verification_declined": {
      "address": null,
      "title": "verification.declined",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "verification_declined": {
          "$ref": "#/components/messages/verification_declined"
        }
      }
    },
    "verification_expired": {
      "address": null,
      "title": "verification.expired",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "verification_expired": {
          "$ref": "#/components/messages/verification_expired"
        }
      }
    },
    "letter_reissued": {
      "address": null,
      "title": "letter.reissued",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "letter_reissued": {
          "$ref": "#/components/messages/letter_reissued"
        }
      }
    },
    "verification_reconfirmed": {
      "address": null,
      "title": "verification.reconfirmed",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "verification_reconfirmed": {
          "$ref": "#/components/messages/verification_reconfirmed"
        }
      }
    },
    "screening_completed": {
      "address": null,
      "title": "screening.completed",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "screening_completed": {
          "$ref": "#/components/messages/screening_completed"
        }
      }
    },
    "screening_alert": {
      "address": null,
      "title": "screening.alert",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "screening_alert": {
          "$ref": "#/components/messages/screening_alert"
        }
      }
    },
    "screening_reviewed": {
      "address": null,
      "title": "screening.reviewed",
      "description": "Delivered by HTTPS POST to the webhook URL you set in your sponsor dashboard.",
      "servers": [
        {
          "$ref": "#/servers/yourEndpoint"
        }
      ],
      "messages": {
        "screening_reviewed": {
          "$ref": "#/components/messages/screening_reviewed"
        }
      }
    }
  },
  "operations": {
    "send_verification_started": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/verification_started"
      },
      "title": "Send verification.started",
      "summary": "verification.started",
      "messages": [
        {
          "$ref": "#/channels/verification_started/messages/verification_started"
        }
      ]
    },
    "send_verification_needs_info": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/verification_needs_info"
      },
      "title": "Send verification.needs_info",
      "summary": "verification.needs_info",
      "messages": [
        {
          "$ref": "#/channels/verification_needs_info/messages/verification_needs_info"
        }
      ]
    },
    "send_verification_completed": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/verification_completed"
      },
      "title": "Send verification.completed",
      "summary": "verification.completed",
      "messages": [
        {
          "$ref": "#/channels/verification_completed/messages/verification_completed"
        }
      ]
    },
    "send_verification_declined": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/verification_declined"
      },
      "title": "Send verification.declined",
      "summary": "verification.declined",
      "messages": [
        {
          "$ref": "#/channels/verification_declined/messages/verification_declined"
        }
      ]
    },
    "send_verification_expired": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/verification_expired"
      },
      "title": "Send verification.expired",
      "summary": "verification.expired",
      "messages": [
        {
          "$ref": "#/channels/verification_expired/messages/verification_expired"
        }
      ]
    },
    "send_letter_reissued": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/letter_reissued"
      },
      "title": "Send letter.reissued",
      "summary": "letter.reissued",
      "messages": [
        {
          "$ref": "#/channels/letter_reissued/messages/letter_reissued"
        }
      ]
    },
    "send_verification_reconfirmed": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/verification_reconfirmed"
      },
      "title": "Send verification.reconfirmed",
      "summary": "verification.reconfirmed",
      "messages": [
        {
          "$ref": "#/channels/verification_reconfirmed/messages/verification_reconfirmed"
        }
      ]
    },
    "send_screening_completed": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/screening_completed"
      },
      "title": "Send screening.completed",
      "summary": "screening.completed",
      "messages": [
        {
          "$ref": "#/channels/screening_completed/messages/screening_completed"
        }
      ]
    },
    "send_screening_alert": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/screening_alert"
      },
      "title": "Send screening.alert",
      "summary": "screening.alert",
      "messages": [
        {
          "$ref": "#/channels/screening_alert/messages/screening_alert"
        }
      ]
    },
    "send_screening_reviewed": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/screening_reviewed"
      },
      "title": "Send screening.reviewed",
      "summary": "screening.reviewed",
      "messages": [
        {
          "$ref": "#/channels/screening_reviewed/messages/screening_reviewed"
        }
      ]
    }
  },
  "components": {
    "messages": {
      "verification_started": {
        "name": "verification.started",
        "title": "verification.started",
        "summary": "verification.started",
        "description": "The investor submitted for CPA review. No letter yet; certificate_id may be null.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "verification.started"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                  ]
                }
              }
            }
          ]
        }
      },
      "verification_needs_info": {
        "name": "verification.needs_info",
        "title": "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>).",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "verification.needs_info"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                  ]
                }
              }
            }
          ]
        }
      },
      "verification_completed": {
        "name": "verification.completed",
        "title": "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.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "verification.completed"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                  ]
                }
              }
            }
          ]
        }
      },
      "verification_declined": {
        "name": "verification.declined",
        "title": "verification.declined",
        "summary": "verification.declined",
        "description": "The CPA declined the case.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "verification.declined"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                  ]
                }
              }
            }
          ]
        }
      },
      "verification_expired": {
        "name": "verification.expired",
        "title": "verification.expired",
        "summary": "verification.expired",
        "description": "An issued letter passed its expiration date.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "verification.expired"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                  ]
                }
              }
            }
          ]
        }
      },
      "letter_reissued": {
        "name": "letter.reissued",
        "title": "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.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "letter.reissued"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                  ]
                }
              }
            }
          ]
        }
      },
      "verification_reconfirmed": {
        "name": "verification.reconfirmed",
        "title": "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.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "verification.reconfirmed"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                  ]
                }
              }
            }
          ]
        }
      },
      "screening_completed": {
        "name": "screening.completed",
        "title": "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.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "screening.completed"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      },
      "screening_alert": {
        "name": "screening.alert",
        "title": "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.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "screening.alert"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      },
      "screening_reviewed": {
        "name": "screening.reviewed",
        "title": "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.",
        "contentType": "application/json",
        "headers": {
          "type": "object",
          "properties": {
            "X-AccreditedNow-Event": {
              "type": "string",
              "const": "screening.reviewed"
            },
            "X-AccreditedNow-Delivery": {
              "type": "string",
              "description": "Same as the envelope id. Dedupe on it."
            },
            "X-AccreditedNow-Signature": {
              "type": "string",
              "description": "t=<unix-seconds>,v1=<hex HMAC-SHA256 of `${t}.${rawBody}` with your signing secret>."
            }
          },
          "required": [
            "X-AccreditedNow-Event",
            "X-AccreditedNow-Delivery",
            "X-AccreditedNow-Signature"
          ]
        },
        "payload": {
          "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"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      }
    },
    "schemas": {
      "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."
          }
        }
      },
      "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"
          }
        }
      },
      "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."
          }
        }
      },
      "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."
          }
        }
      },
      "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"
          }
        }
      },
      "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"
            ]
          }
        }
      },
      "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"
          }
        }
      },
      "Status": {
        "type": "string",
        "enum": [
          "created",
          "in_review",
          "verified",
          "expired",
          "declined",
          "refunded"
        ]
      },
      "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"
            ]
          }
        }
      }
    }
  }
}
