Create a Validation Submission

POST 
/v1/validation-submissions

Create a Validation Submission

Request

Header Parameters

Idempotency-Key string

Idempotency key

application/json

Body

required

oneOf

MOD1

configurationId string

Id of the Validation Submission Configuration associated with submission

organisationName stringrequired

Possible values: <= 255 characters

Name of organisation

registryName stringrequired

Possible values: <= 255 characters

Name of organisation's registry

registryId stringrequired

Organisations's id in registry

organisationEmail string

Possible values: <= 255 characters

Organisation's email

addressLine1 string

Possible values: <= 255 characters

Organisation's address line 1

addressLine2 string

Possible values: <= 255 characters

Organisation's address line 2

city string

Possible values: <= 255 characters

Organisation's city

postal string

Possible values: <= 255 characters

Organisation's postal code

state string

Possible values: <= 255 characters

Organisation's state

website websiterequired

Possible values: <= 255 characters

Organisation's website

countryCode stringrequired

Three-letter ISO country code

firstName string

Possible values: <= 255 characters

First name of Agent

lastName string

Possible values: <= 255 characters

Last name of Agent

email string

Possible values: <= 255 characters

Email of Agent

title string

Possible values: <= 255 characters

Agent's job title

language stringrequired

Valid RFC 5646 language code

metadata object

Metadata object.

property name* string

Max key size is 40 characters

MOD2

configurationId string

Id of the Validation Submission Configuration

organisationId stringrequired

OrganisationId of the Agent

firstName string

Possible values: <= 255 characters

First name of Agent

lastName string

Possible values: <= 255 characters

Last name of Agent

email string

Possible values: <= 255 characters

Email of Agent

title string

Possible values: <= 255 characters

Agent's job title

website website

Possible values: <= 255 characters

Organization's website

language stringrequired

Valid RFC 5646 language code

metadata object

Metadata object.

property name* string

Max key size is 40 characters. If key matches already existing key, it will override old value

Responses

200

Successfully created a Validation Submission

application/json

Schema

Schema

data object

id string

validationInviteId stringnullable

status string

Possible values: [pending, failed, succeeded, processed]

processedAt date-timenullable

organisationId stringnullable

organisationName stringnullable

monitoringSubscriptionId stringnullable

eligibilitySubscriptionId stringnullable

createdAt date-time

agentVerificationId stringnullable

agentVerification objectnullable

id string

email string

firstName string

lastName string

status string

Possible values: [pending, pending_user_verification, pending_review, approved, rejected]

rejectionReason stringnullabledeprecated

Possible values: [Validation request failed, User verification expired, Identity check failed, No evidence agent’s email is associated with organisation, Agent/nonprofit will reapply, Agent used fake or test email, No online presence to complete check, Nonprofit association expired, Other]

Reason for rejecting agent verification

rejectionReasonCode stringnullable

Possible values: [validation_request_failed, user_verification_expired, user_failed_percent_review, reapply, fake_email_used, no_online_presence, invalid_documentation, nonprofit_association_expired, fake_documentation, mismatched_information, blank_corrupted_documentation, suspicious_application, other]

Reason code for rejecting agent verification

validationRequestId stringnullable

validationRequest objectnullable

acceptedAt date-timenullable

rejectedAt date-timenullable

id string

name stringnullable

organisationTypes string[]

Possible values: [nonprofit, social_impact]

eligibility object

status string

Possible values: [live, pending_validation_request, validation_request_failed, pending, cancelled, cannot_define_eligibility]

results object

eligibilityStatus stringnullable

Possible values: [pass, fail]

confirmedActivitySubTags string[]nullable

rejectedActivitySubTags string[]nullable

Confirmed organisation's activity subtags that are not allowed in partner's configuration

monitoring object

status string

Possible values: [live, pending_validation_request, validation_request_failed, pending, cancelled]

results object

complianceStatus stringnullable

Possible values: [pass, fail]

registration object

active string

Possible values: [yes, no]

warning objectnullable

status string

Possible values: [clear, flag]

sanction objectnullable

status string

Possible values: [clear, flag]

controversial objectnullable

status string

Possible values: [clear, flag]

commercial objectnullable

status string

Possible values: [clear, flag]

adverseMedia objectnullable

status string

Possible values: [clear, flag]

hateSpeech objectnullable

status string

Possible values: [clear, flag]

configuration object

id string

Validation Submission configuration id

name stringnullable

Validation Submission configuration name

metadata objectnullable

Key-value data that you can attach to an object.

partnerFields objectnullable

Responses for custom partner questions

object string

Example (from schema)

{
  "data": {
    "id": "validationsubmission_xxxxxxxxxxxx",
    "validationInviteId": "validationinvite_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "pending",
    "processedAt": "2022-02-02T17:46:54.000Z",
    "organisationId": "organisation_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "organisationName": "string",
    "monitoringSubscriptionId": "monitoringsubscription_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "eligibilitySubscriptionId": "eligibilitysubscription_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "createdAt": "2022-02-02T17:46:54.000Z",
    "agentVerificationId": "agentverification_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "agentVerification": {
      "id": "validationrequest_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "email": "string",
      "firstName": "string",
      "lastName": "string",
      "status": "pending",
      "rejectionReasonCode": "validation_request_failed"
    },
    "validationRequestId": "validationrequest_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "validationRequest": {
      "acceptedAt": "2022-02-02T17:46:54.000Z",
      "rejectedAt": "2022-02-02T17:46:54.000Z",
      "id": "validationrequest_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "name": "string",
      "organisationTypes": [
        "nonprofit"
      ]
    },
    "eligibility": {
      "status": "live",
      "results": {
        "eligibilityStatus": "fail",
        "confirmedActivitySubTags": [
          "activitysubtag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        ],
        "rejectedActivitySubTags": [
          "activitysubtag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        ]
      }
    },
    "monitoring": {
      "status": "live",
      "results": {
        "complianceStatus": "fail",
        "registration": {
          "active": "no"
        },
        "warning": {
          "status": "flag"
        },
        "sanction": {
          "status": "flag"
        },
        "controversial": {
          "status": "flag"
        },
        "commercial": {
          "status": "flag"
        },
        "adverseMedia": {
          "status": "clear"
        },
        "hateSpeech": {
          "status": "flag"
        }
      }
    },
    "configuration": {
      "id": "hostedconfiguration_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "name": "string"
    },
    "metadata": {
      "key1": "value1",
      "key2": "value2"
    },
    "partnerFields": {
      "key1": "value1",
      "key2": "value2"
    }
  },
  "object": "validation_submission"
}

400

Bad request

application/json

Schema

Schema

error object
code string
title string
message string
reasons string[]nullable

Example (from schema)

{
  "error": {
    "code": "string",
    "title": "string",
    "message": "string",
    "reasons": [
      "string"
    ]
  }
}

OrganisationNotFound

400 Bad request

{
  "error": {
    "code": "validation_submission/organisation_not_found",
    "title": "Bad request",
    "message": "Organisation was not found"
  }
}

OrganisationNotActive

400 Bad request

{
  "error": {
    "code": "validation_submission/organisation_not_active",
    "title": "Bad request",
    "message": "Organisation is not active"
  }
}

ValidationSubmissionDocumentNotFound

400 Bad request

{
  "error": {
    "code": "validation_submission/validation_submission_document_not_found",
    "title": "Bad request",
    "message": "Validation submission document was not found"
  }
}

ValidationRequestNotFound

400 Bad request

{
  "error": {
    "code": "validation_submission/validation_request_not_found",
    "title": "Bad request",
    "message": "Validation request was not found"
  }
}

ValidationRequestAlreadyRejected

400 Bad request

{
  "error": {
    "code": "validation_submission/validation_request_already_rejected",
    "title": "Bad request",
    "message": "Validation request already rejected"
  }
}

EntityNotFound

400 Bad request

{
  "error": {
    "code": "validation_submission/entity_not_found",
    "title": "Bad request",
    "message": "Organisation or validation request was not found"
  }
}

InvalidSubTags

400 Bad request

{
  "error": {
    "code": "validation_submission/invalid_sub_tags",
    "title": "Bad request",
    "message": "At least one of provided subtags is invalid"
  }
}

InvalidConfiguration

404 Not Found

{
  "error": {
    "code": "validation_submission/invalid_configuration_id",
    "title": "Not Found",
    "message": "Provided configurationId is not valid"
  }
}

OriginalCallInProgress

Idempotency - Original call in progress

{
  "error": {
    "code": "idempotency/original_call_in_progress",
    "title": "Bad request",
    "message": "Original call with this idempotency key is still in progress"
  }
}

SameKeyDifferentData

Idempotency - Data has changed from previous request

{
  "error": {
    "code": "idempotency/same_key_different_data",
    "title": "Bad request",
    "message": "Data has changed from previous request"
  }
}

KeyInUse

Idempotency - Key in use

{
  "error": {
    "code": "idempotency/key_already_in_use",
    "title": "Bad request",
    "message": "Idempotency Key is already in use"
  }
}

401

Unauthorized

403

Forbidden (scope)

application/json

Schema

Schema

error object
code string
title string
message string

Example (from schema)

{
  "error": {
    "code": "forbidden",
    "title": "Forbidden",
    "message": "Access is denied due to missing scope permissions"
  }
}

Loading...