Clarification on new verification date fields in REST JSON API

API Question
1

Following the discussion on IDV deadlines from last Friday — where it was mentioned that the REST JSON API will soon include new verification date fields (e.g. VERIFICATION_STMT_DATE, VERIFICATION_STMT_DUE_DATE, APPT_VERIFICATION_EFF_DATE, APPT_VERIFICATION_END_DATE) — I wanted to confirm a few details.

Will these new fields and date values be available when creating and retrieving company profiles from the test REST API?

For reference:

  1. Create test company:
    Sandbox Test Data Generator API: Create a test company

  2. Get company profile:
    Companies House Public Data API: companyProfile

Thanks in advance for confirming how and when these new date fields will be reflected in the test API.

2 Likes
2

Just following up on my earlier question about the new IDV verification date fields — specifically VERIFICATION_STMT_DATE, VERIFICATION_STMT_DUE_DATE, APPT_VERIFICATION_EFF_DATE, and APPT_VERIFICATION_END_DATE.

From the latest developer specs at Companies House Public Data API: list, I can see the following fields now appear under identity_verification_details:

  • appointment_verification_statement_date
  • appointment_verification_statement_due_on
  • appointment_verification_start_on
  • appointment_verification_end_on

It looks like:

  • VERIFICATION_STMT_DATE → appointment_verification_statement_date
  • VERIFICATION_STMT_DUE_DATE → appointment_verification_statement_due_on
  • APPT_VERIFICATION_EFF_DATE → not yet documented / available

Could Companies House please confirm:

  1. When these new identity_verification_details fields will start appearing in the test REST API (both in the Public Data API and the Sandbox Test Data Generator)?
  2. Whether there’s any timeline for the missing APPT_VERIFICATION_EFF_DATE (effective date) field to be added?

Thanks in advance for any clarification — this will help us plan API integration updates ahead of the IDV rollout.