{"openapi":"3.1.0","info":{"title":"PPAI-ETMS Insurer Transmission API","version":"1.0.0","description":"Machine-to-machine API for insurers, pools and management companies to transmit Passenger Personal Accident Insurance (PPAI) records to LTFRB. All responses use the envelope `{ success, data, error }`. Authenticate with OAuth2 client credentials, then sign every /ppai request with HMAC-SHA256."},"servers":[{"url":"https://api-ppai.supremealliance.dev"}],"tags":[{"name":"Authentication"},{"name":"PPAI records"},{"name":"Transmissions"},{"name":"Vehicles"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Opaque access token from POST /api/v1/oauth/token (valid 15 minutes)."},"ppaiClientId":{"type":"apiKey","in":"header","name":"X-PPAI-Client-Id","description":"Your public client_id (must match the access token)."},"ppaiTimestamp":{"type":"apiKey","in":"header","name":"X-PPAI-Timestamp","description":"Unix time in seconds; must be within ±300 s of server time."},"ppaiNonce":{"type":"apiKey","in":"header","name":"X-PPAI-Nonce","description":"16–64 random characters, unique per client for 10 minutes."},"ppaiSignature":{"type":"apiKey","in":"header","name":"X-PPAI-Signature","description":"hex(HMAC-SHA256(signing_secret, METHOD + \"\\n\" + PATH_WITH_QUERY + \"\\n\" + TIMESTAMP + \"\\n\" + NONCE + \"\\n\" + hex(SHA256(raw body))))"}},"schemas":{},"parameters":{}},"paths":{"/api/v1/oauth/token":{"post":{"tags":["Authentication"],"summary":"Obtain an access token (OAuth2 client credentials)","description":"Accepts application/x-www-form-urlencoded or JSON; client credentials may also be sent with HTTP Basic authentication. Limited to 20 requests per minute per IP.","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"grant_type":{"type":"string","enum":["client_credentials"]},"client_id":{"type":"string","minLength":1,"maxLength":100},"client_secret":{"type":"string","minLength":1,"maxLength":256},"scope":{"type":"string","maxLength":200}},"required":["grant_type","client_id","client_secret"]}},"application/json":{"example":{"grant_type":"client_credentials","client_id":"ppai_live_3f9a1c2b7d4e5f60","client_secret":"••••••••","scope":"ppai:transmit ppai:read"},"schema":{"type":"object","properties":{"grant_type":{"type":"string","enum":["client_credentials"]},"client_id":{"type":"string","minLength":1,"maxLength":100},"client_secret":{"type":"string","minLength":1,"maxLength":256},"scope":{"type":"string","maxLength":200}},"required":["grant_type","client_id","client_secret"]}}}},"responses":{"200":{"description":"Access token issued.","content":{"application/json":{"example":{"success":true,"data":{"access_token":"q0c2…","token_type":"Bearer","expires_in":900,"scope":"ppai:transmit ppai:read"},"error":null},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"access_token":{"type":"string"},"token_type":{"type":"string","enum":["Bearer"]},"expires_in":{"type":"integer"},"scope":{"type":"string"}},"required":["access_token","token_type","expires_in","scope"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"422":{"description":"VALIDATION_FAILED, DUPLICATE_TRANSMISSION, COC_ALREADY_REGISTERED, VEHICLE_ALREADY_INSURED, IMMUTABLE_FIELD, RECORD_MISMATCH or RECORD_CANCELLED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}},"/api/v1/ppai/policies":{"post":{"tags":["PPAI records"],"summary":"Transmit a PPAI policy / Certificate of Cover","description":"Requires scope `ppai:transmit`. Idempotent on `externalTransactionId`. ACCEPTED means accepted as an electronic transmission only.","security":[{"bearerAuth":[],"ppaiClientId":[],"ppaiTimestamp":[],"ppaiNonce":[],"ppaiSignature":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"externalTransactionId":"INS-0001-20260917-000123","issuingInsurerCode":"INS-0001","poolCode":"POOL-0001","policy":{"policyNumber":"PPAI-2026-000123","issuanceDate":"2026-09-17","coverageType":"PPAI_STANDARD","premiumAmount":1850,"officialReceiptNumber":"OR-2026-004512"},"certificate":{"cocNumber":"COC-2026-000456","effectiveDate":"2026-09-17","expirationDate":"2027-09-16"},"operator":{"name":"Sample Transport Cooperative","operatorType":"COOPERATIVE","tin":"123-456-789-000","address":"Quezon City, Metro Manila","region":"NCR","caseNumber":"2019-NCR-001234"},"vehicles":[{"plateNumber":"NBC 1234","mvFileNumber":"1301-0000-0123456","engineNumber":"4D56EAB1234","chassisNumber":"MPATFS77H1234567","make":"Isuzu","model":"Traviz","yearModel":2022,"vehicleType":"MODERN_JEEPNEY","denomination":"PUJ","passengerCapacity":22,"region":"NCR","route":"Quiapo – Cubao"}]},"schema":{"type":"object","properties":{"externalTransactionId":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9._:-]+$"},"issuingInsurerCode":{"type":["string","null"],"maxLength":32},"poolCode":{"type":["string","null"],"maxLength":32},"policy":{"type":"object","properties":{"policyNumber":{"type":["string","null"],"maxLength":64},"issuanceDate":{"type":["string","null"],"maxLength":10},"coverageType":{"type":["string","null"],"maxLength":64},"premiumAmount":{"type":["number","null"],"minimum":0,"maximum":1000000000},"officialReceiptNumber":{"type":["string","null"],"maxLength":64},"remarks":{"type":["string","null"],"maxLength":1000}}},"certificate":{"type":"object","properties":{"cocNumber":{"type":["string","null"],"maxLength":64},"effectiveDate":{"type":["string","null"],"maxLength":10},"expirationDate":{"type":["string","null"],"maxLength":10},"insurerVerificationReference":{"type":["string","null"],"maxLength":128}}},"operator":{"type":"object","properties":{"name":{"type":["string","null"],"maxLength":255},"operatorType":{"type":["string","null"],"enum":["INDIVIDUAL","CORPORATION","COOPERATIVE",null]},"businessName":{"type":["string","null"],"maxLength":255},"tin":{"type":["string","null"],"maxLength":20},"address":{"type":["string","null"],"maxLength":500},"region":{"type":["string","null"],"enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM",null]},"contactEmail":{"type":["string","null"],"maxLength":255},"contactPhone":{"type":["string","null"],"maxLength":32},"caseNumber":{"type":["string","null"],"maxLength":64},"cpcNumber":{"type":["string","null"],"maxLength":64},"franchiseNumber":{"type":["string","null"],"maxLength":64}}},"vehicles":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"],"maxLength":16},"mvFileNumber":{"type":["string","null"],"maxLength":32},"engineNumber":{"type":["string","null"],"maxLength":32},"chassisNumber":{"type":["string","null"],"maxLength":32},"vin":{"type":["string","null"],"maxLength":32},"make":{"type":["string","null"],"maxLength":64},"model":{"type":["string","null"],"maxLength":64},"series":{"type":["string","null"],"maxLength":64},"yearModel":{"type":["integer","null"],"minimum":1950,"maximum":2100},"vehicleType":{"type":["string","null"],"enum":["JEEPNEY","MODERN_JEEPNEY","UV_EXPRESS","BUS","MINIBUS","TAXI","TNVS","FILCAB","TRUCK_FOR_HIRE","SCHOOL_SERVICE","TOURIST_TRANSPORT","MOTORCYCLE_TAXI","OTHER",null]},"denomination":{"type":["string","null"],"enum":["PUJ","PUB","UVE","TX","TNVS","FC","TH","SS","TT","MCT","OTHER",null]},"passengerCapacity":{"type":["integer","null"]},"caseNumber":{"type":["string","null"],"maxLength":64},"cpcNumber":{"type":["string","null"],"maxLength":64},"region":{"type":["string","null"],"enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM",null]},"province":{"type":["string","null"],"maxLength":128},"route":{"type":["string","null"],"maxLength":500}}},"maxItems":500}},"required":["externalTransactionId","policy","certificate","operator","vehicles"]}}}},"responses":{"200":{"description":"Idempotent replay of an earlier identical request (`replayed: true`).","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"201":{"description":"Registered (status ACCEPTED or FLAGGED).","content":{"application/json":{"example":{"success":true,"data":{"status":"ACCEPTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":"LTFRB-PPAI-2026-000045678","ltfrbReference":"LTFRB-PPAI-2026-000045678","externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":"ACTIVE","version":1,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":null},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"404":{"description":"NOT_FOUND","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"409":{"description":"IDEMPOTENCY_KEY_REUSED (the externalTransactionId was used for a different request) or TRANSMISSION_IN_PROGRESS (still processing — retry after ~30 s). `data` is { transmissionReference, status } of the existing transmission.","content":{"application/json":{"example":{"success":false,"data":{"transmissionReference":"PPAI-TX-2026-0000012345","status":"VALIDATING"},"error":{"code":"TRANSMISSION_IN_PROGRESS","message":"A transmission with this externalTransactionId is still being processed. Retry shortly."}},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"transmissionReference":{"type":"string","description":"PPAI-TX reference of the existing transmission"},"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"],"description":"Its current status"}},"required":["transmissionReference","status"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"422":{"description":"Rejected. `data` carries the acknowledgment with status REJECTED; `error.details` lists findings. VEHICLE_ALREADY_INSURED: a vehicle may have only one in-force PPAI coverage across all insurers — the details name the insurer and expiration date only.","content":{"application/json":{"examples":{"validationFailed":{"summary":"Validation failed","value":{"success":false,"data":{"status":"REJECTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":null,"ltfrbReference":null,"externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":null,"version":null,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":{"code":"VALIDATION_FAILED","message":"Transmission failed validation.","details":[{"field":"vehicles[0].chassisNumber","code":"REQUIRED","level":1,"severity":"ERROR","message":"Chassis number is required."}]}}},"vehicleAlreadyInsured":{"summary":"Vehicle already insured (one in-force coverage per vehicle)","value":{"success":false,"data":{"status":"REJECTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":null,"ltfrbReference":null,"externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":null,"version":null,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":{"code":"VEHICLE_ALREADY_INSURED","message":"Vehicle is already insured.","details":[{"field":"vehicles[0].plateNumber","code":"VEHICLE_ALREADY_INSURED","level":3,"severity":"ERROR","message":"Vehicle NBC 1234 is already insured by Sample Insurance Corporation until 2027-03-31."}]}}}},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}},"/api/v1/ppai/policies/search":{"get":{"tags":["PPAI records"],"summary":"Search registered records","description":"Requires scope `ppai:read`. At least one identifier or policy/COC number is required. Results are limited to records visible to your organization.","security":[{"bearerAuth":[],"ppaiClientId":[],"ppaiTimestamp":[],"ppaiNonce":[],"ppaiSignature":[]}],"parameters":[{"schema":{"type":"string"},"required":false,"name":"plateNumber","in":"query"},{"schema":{"type":"string"},"required":false,"name":"mvFileNumber","in":"query"},{"schema":{"type":"string"},"required":false,"name":"chassisNumber","in":"query"},{"schema":{"type":"string"},"required":false,"name":"engineNumber","in":"query"},{"schema":{"type":"string"},"required":false,"name":"policyNumber","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cocNumber","in":"query"},{"schema":{"type":"string","enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200},"required":false,"name":"pageSize","in":"query"}],"responses":{"200":{"description":"Matching records.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ltfrbReference":{"type":"string"},"policyNumber":{"type":"string"},"cocNumber":{"type":"string"},"effectiveDate":{"type":"string"},"expirationDate":{"type":"string"},"coverageStatus":{"type":"string","enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED"]},"lifecycle":{"type":"string","enum":["CURRENT","CANCELLED"]},"currentVersion":{"type":"integer"},"issuingInsurer":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"transmittingOrg":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"pool":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"operatorName":{"type":"string"},"region":{"type":"string","enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"vehicleCount":{"type":"integer"},"openFlagCount":{"type":"integer"},"registeredAt":{"type":"string"}},"required":["id","ltfrbReference","policyNumber","cocNumber","effectiveDate","expirationDate","coverageStatus","lifecycle","currentVersion","issuingInsurer","transmittingOrg","pool","operatorName","region","plateNumbers","vehicleCount","openFlagCount","registeredAt"]}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}},"required":["items","page","pageSize","total"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"422":{"description":"VALIDATION_FAILED, DUPLICATE_TRANSMISSION, COC_ALREADY_REGISTERED, VEHICLE_ALREADY_INSURED, IMMUTABLE_FIELD, RECORD_MISMATCH or RECORD_CANCELLED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}},"/api/v1/ppai/policies/{ltfrbReference}":{"get":{"tags":["PPAI records"],"summary":"Get a registered record","description":"Requires scope `ppai:read`. Operator personal data is masked.","security":[{"bearerAuth":[],"ppaiClientId":[],"ppaiTimestamp":[],"ppaiNonce":[],"ppaiSignature":[]}],"parameters":[{"schema":{"type":"string","description":"LTFRB reference, e.g. LTFRB-PPAI-2026-000045678"},"required":true,"description":"LTFRB reference, e.g. LTFRB-PPAI-2026-000045678","name":"ltfrbReference","in":"path"}],"responses":{"200":{"description":"Record detail with versions, amendments and flags.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"ltfrbReference":{"type":"string"},"policyNumber":{"type":"string"},"cocNumber":{"type":"string"},"effectiveDate":{"type":"string"},"expirationDate":{"type":"string"},"coverageStatus":{"type":"string","enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED"]},"lifecycle":{"type":"string","enum":["CURRENT","CANCELLED"]},"currentVersion":{"type":"integer"},"issuingInsurer":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"transmittingOrg":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"pool":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"operatorName":{"type":"string"},"region":{"type":"string","enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"vehicleCount":{"type":"integer"},"openFlagCount":{"type":"integer"},"registeredAt":{"type":"string"},"policy":{"type":"object","properties":{"policyNumber":{"type":"string"},"issuanceDate":{"type":"string"},"coverageType":{"type":"string"},"premiumAmount":{"type":["string","null"]},"officialReceiptNumber":{"type":["string","null"]},"remarks":{"type":["string","null"]},"leadInsurer":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"managementCompany":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]}},"required":["policyNumber","issuanceDate","coverageType","premiumAmount","officialReceiptNumber","remarks","leadInsurer","managementCompany"]},"insurerVerificationRef":{"type":["string","null"]},"operator":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"operatorType":{"type":"string","enum":["INDIVIDUAL","CORPORATION","COOPERATIVE"]},"businessName":{"type":["string","null"]},"tinMasked":{"type":["string","null"]},"address":{"type":["string","null"]},"region":{"type":"string","enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM"]},"contactEmailMasked":{"type":["string","null"]},"contactPhoneMasked":{"type":["string","null"]},"caseNumber":{"type":["string","null"]},"cpcNumber":{"type":["string","null"]},"franchiseNumber":{"type":["string","null"]}},"required":["id","name","operatorType","businessName","tinMasked","address","region","contactEmailMasked","contactPhoneMasked","caseNumber","cpcNumber","franchiseNumber"]},"vehicles":{"type":"array","items":{"type":"object","properties":{"vehicle":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"plateNumber":{"type":"string"},"mvFileNumber":{"type":"string"},"engineNumber":{"type":"string"},"chassisNumber":{"type":"string"},"make":{"type":["string","null"]},"model":{"type":["string","null"]},"yearModel":{"type":["integer","null"]},"vehicleType":{"type":"string","enum":["JEEPNEY","MODERN_JEEPNEY","UV_EXPRESS","BUS","MINIBUS","TAXI","TNVS","FILCAB","TRUCK_FOR_HIRE","SCHOOL_SERVICE","TOURIST_TRANSPORT","MOTORCYCLE_TAXI","OTHER"]},"denomination":{"type":"string","enum":["PUJ","PUB","UVE","TX","TNVS","FC","TH","SS","TT","MCT","OTHER"]},"passengerCapacity":{"type":"integer"},"region":{"type":"string","enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM"]},"caseNumber":{"type":["string","null"]},"cpcNumber":{"type":["string","null"]}},"required":["id","plateNumber","mvFileNumber","engineNumber","chassisNumber","make","model","yearModel","vehicleType","denomination","passengerCapacity","region","caseNumber","cpcNumber"]},"transmitted":{"type":"object","properties":{"plateNumber":{"type":"string"},"mvFileNumber":{"type":"string"},"engineNumber":{"type":"string"},"chassisNumber":{"type":"string"}},"required":["plateNumber","mvFileNumber","engineNumber","chassisNumber"]},"refMatchResult":{"type":["string","null"]},"addedInVersion":{"type":"integer"},"removedInVersion":{"type":["integer","null"]}},"required":["vehicle","transmitted","refMatchResult","addedInVersion","removedInVersion"]}},"versions":{"type":"array","items":{"type":"object","properties":{"version":{"type":"integer"},"coverageStatus":{"type":"string","enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED"]},"createdAt":{"type":"string"},"supersededAt":{"type":["string","null"]},"transmissionReference":{"type":"string"},"channel":{"type":"string","enum":["API","PORTAL","BULK_UPLOAD"]},"actor":{"type":"string"},"snapshot":{"type":"object","additionalProperties":{}}},"required":["version","coverageStatus","createdAt","supersededAt","transmissionReference","channel","actor","snapshot"]}},"amendments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"fromVersion":{"type":"integer"},"toVersion":{"type":"integer"},"reason":{"type":"string"},"diff":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"before":{},"after":{}},"required":["path"]}},"organization":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"actor":{"type":"string"},"transmissionReference":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","fromVersion","toVersion","reason","diff","organization","actor","transmissionReference","createdAt"]}},"cancellation":{"type":["object","null"],"properties":{"cancellationEffectiveDate":{"type":"string"},"reasonCode":{"type":"string","enum":["NON_PAYMENT","OPERATOR_REQUEST","VEHICLE_DROPPED","ISSUED_IN_ERROR","REPLACED","FRANCHISE_REVOKED","OTHER"]},"reasonText":{"type":"string"},"supportingReference":{"type":["string","null"]},"documentId":{"type":["string","null"],"format":"uuid"},"organization":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"actor":{"type":"string"},"transmissionReference":{"type":"string"},"createdAt":{"type":"string"}},"required":["cancellationEffectiveDate","reasonCode","reasonText","supportingReference","documentId","organization","actor","transmissionReference","createdAt"]},"flags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"status":{"type":"string","enum":["OPEN","CLEARED","REFERRED_TO_INSURER","RESOLVED_BY_AMENDMENT"]},"certificateId":{"type":"string","format":"uuid"},"ltfrbReference":{"type":"string"},"relatedCertificateId":{"type":["string","null"],"format":"uuid"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"insurerName":{"type":"string"},"relatedInsurerName":{"type":["string","null"]},"region":{"type":"string","enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM"]},"details":{"type":"object","additionalProperties":{}},"message":{"type":"string"},"reviewedBy":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewNotes":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","type","status","certificateId","ltfrbReference","relatedCertificateId","relatedLtfrbReference","plateNumber","insurerName","relatedInsurerName","region","details","message","reviewedBy","reviewedAt","reviewNotes","createdAt"]}},"transmissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"transmissionReference":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"channel":{"type":"string","enum":["API","PORTAL","BULK_UPLOAD"]},"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmittingOrg":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["LTFRB","INSURANCE_POOL","MANAGEMENT_COMPANY","INSURANCE_COMPANY"]}},"required":["id","code","name","type"]},"externalTransactionId":{"type":"string"},"ltfrbReference":{"type":["string","null"]},"policyNumber":{"type":["string","null"]},"cocNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"errorCode":{"type":["string","null"]},"actor":{"type":"string"},"receivedAt":{"type":"string"},"completedAt":{"type":["string","null"]}},"required":["id","transmissionReference","kind","channel","status","transmittingOrg","externalTransactionId","ltfrbReference","policyNumber","cocNumber","plateNumbers","errorCode","actor","receivedAt","completedAt"]}},"disclaimer":{"type":"string"}},"required":["id","ltfrbReference","policyNumber","cocNumber","effectiveDate","expirationDate","coverageStatus","lifecycle","currentVersion","issuingInsurer","transmittingOrg","pool","operatorName","region","plateNumbers","vehicleCount","openFlagCount","registeredAt","policy","insurerVerificationRef","operator","vehicles","versions","amendments","cancellation","flags","transmissions","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"404":{"description":"NOT_FOUND","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}},"/api/v1/ppai/policies/{ltfrbReference}/amendments":{"post":{"tags":["PPAI records"],"summary":"Amend a registered record","description":"Requires scope `ppai:amend`. Creates a new immutable version. Insurer code, policy number and COC number cannot be amended (IMMUTABLE_FIELD).","security":[{"bearerAuth":[],"ppaiClientId":[],"ppaiTimestamp":[],"ppaiNonce":[],"ppaiSignature":[]}],"parameters":[{"schema":{"type":"string","description":"LTFRB reference, e.g. LTFRB-PPAI-2026-000045678"},"required":true,"description":"LTFRB reference, e.g. LTFRB-PPAI-2026-000045678","name":"ltfrbReference","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"example":{"externalTransactionId":"INS-0001-20260920-000124","reason":"Correcting chassis number encoding error","changes":{"vehicles":[{"plateNumber":"NBC 1234","mvFileNumber":"1301-0000-0123456","engineNumber":"4D56EAB1234","chassisNumber":"MPATFS77H1234568","make":"Isuzu","model":"Traviz","yearModel":2022,"vehicleType":"MODERN_JEEPNEY","denomination":"PUJ","passengerCapacity":22,"region":"NCR","route":"Quiapo – Cubao"}]}},"schema":{"type":"object","properties":{"externalTransactionId":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9._:-]+$"},"reason":{"type":"string","minLength":10,"maxLength":500},"changes":{"type":"object","properties":{"poolCode":{"type":["string","null"],"maxLength":32},"policy":{"type":"object","properties":{"policyNumber":{"type":["string","null"],"maxLength":64},"issuanceDate":{"type":["string","null"],"maxLength":10},"coverageType":{"type":["string","null"],"maxLength":64},"premiumAmount":{"type":["number","null"],"minimum":0,"maximum":1000000000},"officialReceiptNumber":{"type":["string","null"],"maxLength":64},"remarks":{"type":["string","null"],"maxLength":1000}}},"certificate":{"type":"object","properties":{"cocNumber":{"type":["string","null"],"maxLength":64},"effectiveDate":{"type":["string","null"],"maxLength":10},"expirationDate":{"type":["string","null"],"maxLength":10},"insurerVerificationReference":{"type":["string","null"],"maxLength":128}}},"operator":{"type":"object","properties":{"name":{"type":["string","null"],"maxLength":255},"operatorType":{"type":["string","null"],"enum":["INDIVIDUAL","CORPORATION","COOPERATIVE",null]},"businessName":{"type":["string","null"],"maxLength":255},"tin":{"type":["string","null"],"maxLength":20},"address":{"type":["string","null"],"maxLength":500},"region":{"type":["string","null"],"enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM",null]},"contactEmail":{"type":["string","null"],"maxLength":255},"contactPhone":{"type":["string","null"],"maxLength":32},"caseNumber":{"type":["string","null"],"maxLength":64},"cpcNumber":{"type":["string","null"],"maxLength":64},"franchiseNumber":{"type":["string","null"],"maxLength":64}}},"vehicles":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"],"maxLength":16},"mvFileNumber":{"type":["string","null"],"maxLength":32},"engineNumber":{"type":["string","null"],"maxLength":32},"chassisNumber":{"type":["string","null"],"maxLength":32},"vin":{"type":["string","null"],"maxLength":32},"make":{"type":["string","null"],"maxLength":64},"model":{"type":["string","null"],"maxLength":64},"series":{"type":["string","null"],"maxLength":64},"yearModel":{"type":["integer","null"],"minimum":1950,"maximum":2100},"vehicleType":{"type":["string","null"],"enum":["JEEPNEY","MODERN_JEEPNEY","UV_EXPRESS","BUS","MINIBUS","TAXI","TNVS","FILCAB","TRUCK_FOR_HIRE","SCHOOL_SERVICE","TOURIST_TRANSPORT","MOTORCYCLE_TAXI","OTHER",null]},"denomination":{"type":["string","null"],"enum":["PUJ","PUB","UVE","TX","TNVS","FC","TH","SS","TT","MCT","OTHER",null]},"passengerCapacity":{"type":["integer","null"]},"caseNumber":{"type":["string","null"],"maxLength":64},"cpcNumber":{"type":["string","null"],"maxLength":64},"region":{"type":["string","null"],"enum":["NCR","CAR","I","II","III","IV-A","MIMAROPA","V","VI","NIR","VII","VIII","IX","X","XI","XII","XIII","BARMM",null]},"province":{"type":["string","null"],"maxLength":128},"route":{"type":["string","null"],"maxLength":500}}},"maxItems":500},"issuingInsurerCode":{"type":["string","null"],"maxLength":32},"policyNumber":{"type":["string","null"],"maxLength":64},"cocNumber":{"type":["string","null"],"maxLength":64}}}},"required":["externalTransactionId","reason","changes"]}}}},"responses":{"200":{"description":"Idempotent replay of an earlier identical request (`replayed: true`).","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"201":{"description":"Amendment registered (new version).","content":{"application/json":{"example":{"success":true,"data":{"status":"ACCEPTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":"LTFRB-PPAI-2026-000045678","ltfrbReference":"LTFRB-PPAI-2026-000045678","externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":"ACTIVE","version":1,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":null},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"404":{"description":"NOT_FOUND","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"409":{"description":"IDEMPOTENCY_KEY_REUSED (the externalTransactionId was used for a different request) or TRANSMISSION_IN_PROGRESS (still processing — retry after ~30 s). `data` is { transmissionReference, status } of the existing transmission.","content":{"application/json":{"example":{"success":false,"data":{"transmissionReference":"PPAI-TX-2026-0000012345","status":"VALIDATING"},"error":{"code":"TRANSMISSION_IN_PROGRESS","message":"A transmission with this externalTransactionId is still being processed. Retry shortly."}},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"transmissionReference":{"type":"string","description":"PPAI-TX reference of the existing transmission"},"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"],"description":"Its current status"}},"required":["transmissionReference","status"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"422":{"description":"Rejected. `data` carries the acknowledgment with status REJECTED; `error.details` lists findings. VEHICLE_ALREADY_INSURED: a vehicle may have only one in-force PPAI coverage across all insurers — the details name the insurer and expiration date only.","content":{"application/json":{"examples":{"validationFailed":{"summary":"Validation failed","value":{"success":false,"data":{"status":"REJECTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":null,"ltfrbReference":null,"externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":null,"version":null,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":{"code":"VALIDATION_FAILED","message":"Transmission failed validation.","details":[{"field":"vehicles[0].chassisNumber","code":"REQUIRED","level":1,"severity":"ERROR","message":"Chassis number is required."}]}}},"vehicleAlreadyInsured":{"summary":"Vehicle already insured (one in-force coverage per vehicle)","value":{"success":false,"data":{"status":"REJECTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":null,"ltfrbReference":null,"externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":null,"version":null,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":{"code":"VEHICLE_ALREADY_INSURED","message":"Vehicle is already insured.","details":[{"field":"vehicles[0].plateNumber","code":"VEHICLE_ALREADY_INSURED","level":3,"severity":"ERROR","message":"Vehicle NBC 1234 is already insured by Sample Insurance Corporation until 2027-03-31."}]}}}},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}},"/api/v1/ppai/policies/{ltfrbReference}/cancellation":{"post":{"tags":["PPAI records"],"summary":"Cancel a registered record","description":"Requires scope `ppai:cancel`. Policy and COC numbers must match the record. `supportingReference` is required for ISSUED_IN_ERROR, REPLACED, FRANCHISE_REVOKED and OTHER.","security":[{"bearerAuth":[],"ppaiClientId":[],"ppaiTimestamp":[],"ppaiNonce":[],"ppaiSignature":[]}],"parameters":[{"schema":{"type":"string","description":"LTFRB reference, e.g. LTFRB-PPAI-2026-000045678"},"required":true,"description":"LTFRB reference, e.g. LTFRB-PPAI-2026-000045678","name":"ltfrbReference","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"example":{"externalTransactionId":"INS-0001-20261001-000125","policyNumber":"PPAI-2026-000123","cocNumber":"COC-2026-000456","cancellationEffectiveDate":"2026-10-01","reasonCode":"NON_PAYMENT","reasonText":"Premium not paid by operator"},"schema":{"type":"object","properties":{"externalTransactionId":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9._:-]+$"},"policyNumber":{"type":"string","minLength":1},"cocNumber":{"type":"string","minLength":1},"cancellationEffectiveDate":{"type":"string"},"reasonCode":{"type":"string","enum":["NON_PAYMENT","OPERATOR_REQUEST","VEHICLE_DROPPED","ISSUED_IN_ERROR","REPLACED","FRANCHISE_REVOKED","OTHER"]},"reasonText":{"type":"string","minLength":5,"maxLength":1000},"supportingReference":{"type":["string","null"],"maxLength":128},"documentId":{"type":["string","null"],"format":"uuid"}},"required":["externalTransactionId","policyNumber","cocNumber","cancellationEffectiveDate","reasonCode","reasonText"]}}}},"responses":{"200":{"description":"Idempotent replay of an earlier identical request (`replayed: true`).","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"201":{"description":"Record cancelled.","content":{"application/json":{"example":{"success":true,"data":{"status":"ACCEPTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":"LTFRB-PPAI-2026-000045678","ltfrbReference":"LTFRB-PPAI-2026-000045678","externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":"ACTIVE","version":1,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":null},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"404":{"description":"NOT_FOUND","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"409":{"description":"IDEMPOTENCY_KEY_REUSED (the externalTransactionId was used for a different request) or TRANSMISSION_IN_PROGRESS (still processing — retry after ~30 s). `data` is { transmissionReference, status } of the existing transmission.","content":{"application/json":{"example":{"success":false,"data":{"transmissionReference":"PPAI-TX-2026-0000012345","status":"VALIDATING"},"error":{"code":"TRANSMISSION_IN_PROGRESS","message":"A transmission with this externalTransactionId is still being processed. Retry shortly."}},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"transmissionReference":{"type":"string","description":"PPAI-TX reference of the existing transmission"},"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"],"description":"Its current status"}},"required":["transmissionReference","status"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"422":{"description":"Rejected. `data` carries the acknowledgment with status REJECTED; `error.details` lists findings.","content":{"application/json":{"example":{"success":false,"data":{"status":"REJECTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":null,"ltfrbReference":null,"externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":null,"version":null,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":{"code":"VALIDATION_FAILED","message":"Transmission failed validation.","details":[{"field":"vehicles[0].chassisNumber","code":"REQUIRED","level":1,"severity":"ERROR","message":"Chassis number is required."}]}},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}},"/api/v1/ppai/transmissions/{transmissionReferenceOrExternalId}":{"get":{"tags":["Transmissions"],"summary":"Get a transmission acknowledgment","description":"Requires scope `ppai:read`. Look up by PPAI-TX reference or your externalTransactionId.","security":[{"bearerAuth":[],"ppaiClientId":[],"ppaiTimestamp":[],"ppaiNonce":[],"ppaiSignature":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"transmissionReferenceOrExternalId","in":"path"}],"responses":{"200":{"description":"Stored acknowledgment.","content":{"application/json":{"example":{"success":true,"data":{"status":"ACCEPTED","transmissionReference":"PPAI-TX-2026-0000012345","transactionReference":"LTFRB-PPAI-2026-000045678","ltfrbReference":"LTFRB-PPAI-2026-000045678","externalTransactionId":"INS-0001-20260917-000123","kind":"CREATE","policyNumber":"PPAI-2026-000123","certificateOfCover":"COC-2026-000456","plateNumber":"NBC1234","plateNumbers":["NBC1234"],"coverageStatus":"ACTIVE","version":1,"receivedAt":"2026-09-17T14:25:18+08:00","replayed":false,"warnings":[],"errors":[],"flags":[],"referenceMatches":[{"plateNumber":"NBC1234","result":"MATCHED"}],"acknowledgmentUrl":null,"disclaimer":"ACCEPTED means the PPAI record was accepted as an electronic transmission to LTFRB. It does not constitute an LTFRB guarantee of the legal validity of the underlying insurance policy."},"error":null},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["RECEIVED","VALIDATING","ACCEPTED","FLAGGED","REJECTED"]},"transmissionReference":{"type":"string"},"transactionReference":{"type":["string","null"],"description":"LTFRB reference (PRD §26 name); null when rejected"},"ltfrbReference":{"type":["string","null"]},"externalTransactionId":{"type":"string"},"kind":{"type":"string","enum":["CREATE","AMEND","CANCEL"]},"policyNumber":{"type":["string","null"]},"certificateOfCover":{"type":["string","null"]},"plateNumber":{"type":["string","null"]},"plateNumbers":{"type":"array","items":{"type":"string"}},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"version":{"type":["integer","null"]},"receivedAt":{"type":"string"},"replayed":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"errors":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"code":{"type":"string"},"field":{"type":["string","null"]},"message":{"type":"string"}},"required":["level","severity","code","field","message"]}},"flags":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["POSSIBLE_DUPLICATE","OVERLAPPING_COVERAGE","VEHICLE_MISMATCH","IDENTIFIER_CONFLICT"]},"message":{"type":"string"},"relatedLtfrbReference":{"type":["string","null"]},"plateNumber":{"type":["string","null"]}},"required":["type","message","relatedLtfrbReference","plateNumber"]}},"referenceMatches":{"type":"array","items":{"type":"object","properties":{"plateNumber":{"type":["string","null"]},"result":{"type":"string","enum":["MATCHED","PARTIAL_MATCH","NO_MATCH","FOR_REVIEW"]}},"required":["plateNumber","result"]}},"acknowledgmentUrl":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["status","transmissionReference","transactionReference","ltfrbReference","externalTransactionId","kind","policyNumber","certificateOfCover","plateNumber","plateNumbers","coverageStatus","version","receivedAt","replayed","warnings","errors","flags","referenceMatches","acknowledgmentUrl","disclaimer"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"404":{"description":"NOT_FOUND","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}},"/api/v1/ppai/vehicles/{identifier}/coverage":{"get":{"tags":["Vehicles"],"summary":"Verify vehicle coverage","description":"Requires scope `vehicles:verify`. Identifier may be a plate, MV file, engine or chassis number. No operator personal data is returned.","security":[{"bearerAuth":[],"ppaiClientId":[],"ppaiTimestamp":[],"ppaiNonce":[],"ppaiSignature":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"identifier","in":"path"}],"responses":{"200":{"description":"Coverage verification result.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":["object","null"],"properties":{"identifier":{"type":"string"},"vehicleFound":{"type":"boolean"},"plateNumber":{"type":["string","null"]},"coverageStatus":{"type":["string","null"],"enum":["ACTIVE","UPCOMING","EXPIRING","EXPIRED","CANCELLED","SUPERSEDED",null]},"insurerName":{"type":["string","null"]},"effectiveDate":{"type":["string","null"]},"expirationDate":{"type":["string","null"]},"ltfrbReference":{"type":["string","null"]},"checkedAt":{"type":"string"}},"required":["identifier","vehicleFound","plateNumber","coverageStatus","insurerName","effectiveDate","expirationDate","ltfrbReference","checkedAt"]},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","data","error"]}}}},"401":{"description":"INVALID_TOKEN, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_RANGE or NONCE_REUSED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"403":{"description":"FORBIDDEN (missing scope / not permitted) or IP_NOT_ALLOWED","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}},"429":{"description":"RATE_LIMITED (see Retry-After)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["UNAUTHENTICATED","FORBIDDEN","MFA_REQUIRED","INVALID_CREDENTIALS","ACCOUNT_LOCKED","SESSION_EXPIRED","CSRF_FAILED","INVALID_TOKEN","INVALID_SIGNATURE","TIMESTAMP_OUT_OF_RANGE","NONCE_REUSED","IP_NOT_ALLOWED","RATE_LIMITED","VALIDATION_FAILED","DUPLICATE_TRANSMISSION","COC_ALREADY_REGISTERED","IDEMPOTENCY_KEY_REUSED","TRANSMISSION_IN_PROGRESS","IMMUTABLE_FIELD","RECORD_MISMATCH","RECORD_CANCELLED","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","UNSUPPORTED_FILE","INVALID_MFA_CODE","VEHICLE_ALREADY_INSURED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":["string","null"]},"code":{"type":"string"},"message":{"type":"string"},"level":{"type":"integer","minimum":1,"maximum":4},"severity":{"type":"string","enum":["ERROR","WARNING","INFO"]},"ltfrbReference":{"type":"string"}},"required":["code","message"]}},"requestId":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]}}}}}}}},"webhooks":{}}