# List TFN Verifications

Lists all TFN verifications per project.

Endpoint: GET /v1/projects/{projectId}/tfnVerification
Version: 1.0
Security: BasicAuth, OAuth2

## Path parameters:

  - `projectId` (string, required)
    Sinch uses projects to group resources such as contacts and apps together to manage and connect a unique set of keys and secret IDs for all your Sinch API products. To identify a project, it is given a unique alphanumeric identifier that ties it to your account. Your project ID can be found in the Customer Dashboard.

## Query parameters:

  - `useCase` (string)
    A use case associated to a verification to be searched

  - `statuses` (array)
    Enum: "STATUS_UNSPECIFIED", "WAITING", "IN_PROGRESS", "VERIFIED", "REJECTED"

  - `pageSize` (integer)

  - `pageToken` (string)

  - `orderBy` (string)

## Response 200 fields (application/json):

  - `tfnVerifications` (array)

  - `tfnVerifications.projectId` (string, required)
    Your project ID can be found in the [Customer Dashboard](https://dashboard.sinch.com/settings/project-management).

  - `tfnVerifications.phoneNumber` (string, required)
    Toll-Free Number that is procured, hosted or in the process of hosting with Sinch. Must be in E.164 format.

  - `tfnVerifications.businessName` (string, required)

  - `tfnVerifications.businessAddress1` (string, required)

  - `tfnVerifications.businessCity` (string, required)

  - `tfnVerifications.businessState` (string, required)

  - `tfnVerifications.businessZipCode` (string, required)

  - `tfnVerifications.businessContactFirstName` (string, required)

  - `tfnVerifications.businessContactLastName` (string, required)

  - `tfnVerifications.businessContactEmail` (string, required)

  - `tfnVerifications.businessContactPhone` (string, required)

  - `tfnVerifications.corporateWebsite` (string, required)

  - `tfnVerifications.messageVolume` (string, required)
    Estimate monthly volume of messages from the TFN (accepted values: 10, 100, 1000, 10000, 100000, 250000, 500000, 750000, 1000000, 5000000, 10000000+)

  - `tfnVerifications.useCase` (string, required)
    Category of the use case, fetched from the dedicated API.

  - `tfnVerifications.useCaseSummary` (string, required)
    General idea of the use case and customer.

  - `tfnVerifications.productionMessageContent` (string, required)
    Example of message content.

  - `tfnVerifications.optInWorkflowDescription` (string, required)
    Description of the opt-in workflow.

  - `tfnVerifications.optInWorkflowImageUrls` (array, required)
    Images showing the opt-in workflow.

  - `tfnVerifications.businessRegistrationNumber` (string, required)
    A legally recognized business registration number.

  - `tfnVerifications.businessType` (string, required)
    The type of business, selected from a list of predefined categories.
    Enum: "SOLE_PROPRIETOR", "PRIVATE_PROFIT", "PUBLIC_PROFIT", "NON_PROFIT", "GOVERNMENT"

  - `tfnVerifications.businessRegistrationCountry` (string, required)
    Country business is registered in.

  - `tfnVerifications.tfnVerificationId` (string, required)
    The unique identifier for the TFN verification request, generated by the server.

  - `tfnVerifications.status` (string, required)
    The current status of the verification request.
    Enum: same as `statuses` (5 values)

  - `tfnVerifications.createTime` (string, required)
    The timestamp when the verification was created, in UTC (RFC3339 format).

  - `tfnVerifications.businessRegistrationType` (string, required)
    The type of business registration (e.g. EIN, CBN, CRN, NEQ, Provincial Number, VAT, ACN, ABN, BRN)

  - `tfnVerifications.businessAddress2` (string)

  - `tfnVerifications.businessCountry` (string)

  - `tfnVerifications.additionalInformation` (string)
    Any additional information.

  - `tfnVerifications.notes` (array)
    Feedback notes added during the review process.

  - `tfnVerifications.notes.note` (string)

  - `tfnVerifications.notes.createTime` (string)

  - `tfnVerifications.createdBy` (string)
    The email of the user who initiated the request.

  - `totalSize` (integer)

  - `nextPageToken` (string)

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    The error code.
    Example: 400

  - `error.message` (string, required)
    The error message.
    Example: "Invalid argument."

  - `error.status` (string)
    The status of the error.
    Example: "INVALID_ARGUMENT"

  - `error.details` (array)
    An array of objects describing the error in more detail, if applicable.

  - `error.details.type` (string)
    A more specific description of the error.
    Example: "BadRequest"

  - `error.details.resourceType` (string)
    The type of resource relevant to the error, if applicable.

  - `error.details.resourceName` (string)
    The name of the resource, if applicable.

  - `error.details.owner` (string)
    The owner of the resource, if applicable.

  - `error.details.description` (string)
    A description of the error, if applicable.

  - `error.details.fieldViolations` (array)
    An array of all the field violations which contributed to the error.

  - `error.details.fieldViolations.field` (string)
    The field which produced the error.
    Example: "order_by"

  - `error.details.fieldViolations.description` (string)
    The description of the error.
    Example: "Invalid `order_by` number."