Get Verification Status

Get the current status and income report for a verification request.

Get Verification

GET/verify?verification_id={id}

Query Parameters

ParameterTypeRequiredDescription
verification_idstringYesThe verification ID returned from the create endpoint

Verification Statuses

pendingWaiting for tenant to complete verification
in_progressTenant has started the verification process
completedVerification complete, income report available
expiredVerification link expired (7 days) or cancelled
failedError during verification process

Example Request

curl -X GET "https://tenantverify.org/api/v1/verify?verification_id=abc123" \
  -H "Authorization: Bearer tv_live_your_api_key"

Response (200 OK)

{
  "success": true,
  "data": {
    "verification_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "tenant": {
      "email": "tenant@example.com",
      "name": "John Doe"
    },
    "property": {
      "address": "123 Main St, Apt 4B",
      "monthly_rent": 2000
    },
    "income_report": {
      "total_monthly_income": 6500.00,
      "income_sources": [
        {
          "name": "ACME Corporation",
          "income_category": "SALARY",
          "pay_frequency": "BIWEEKLY",
          "monthly_income": 5200.00
        },
        {
          "name": "Freelance Work",
          "income_category": "SELF_EMPLOYMENT",
          "monthly_income": 1300.00
        }
      ],
      "verification_method": "bank",
      "confidence_score": 0.95,
      "rent_to_income_ratio": 0.31,
      "passes_3x_rule": true
    },
    "created_at": "2024-01-23T10:00:00.000Z",
    "completed_at": "2024-01-24T14:30:00.000Z"
  }
}
← Create VerificationList Verifications →