Add Organization
POST/api/experian/organizations/:organizationId
Registers a new Property Management Company organization and initiates authentication.
Organizations represent PMC entities with multiple agents who need to evaluate renter reports for lease-worthiness.
The organization is registered using the contact person's identity details
(the same passive-user payload used for renter and agent registration). The
companyName field carries the business name. There is no separate name,
taxId, or address field — supply the contact's firstName/lastName and
address fields instead.
Request
Responses
- 200
- 400
- 403
- 409
- 423
- 503
Organization registered (or registration step-up required). The payload is
the Experian passive-user response passed through unchanged — depending on
the outcome it contains the KBA challenge plus session identifiers, or the
completed registration result. If the organization is already registered and
authenticated, the current registration state is returned.
Invalid request data
Invalid API key
Organization already registered (errorCode 292)
Organization blocked by Experian after repeated failed attempts (errorCode 300)
Experian token service unavailable (errorCode 123)