---
title: "Get Business by Email"
method: POST
path: "/get-by-email"
tags: ["business"]
---

# Get Business by Email

`POST /get-by-email`

Fetch a business by their email address if it exists. This API returns a 404 if the business does not exist

## Request body

- BusinessGetByEmailRequest
  - `email` string, email, required — Email address of the business

## Response `200`

success

- BusinessDetailsResponse
  - `businessId` string, uuid, required — Business ID
  - `companyName` string, required — Name of the Company
  - `registrationCountry` string — Country to which, company is registered (in ISO 3166 alpha-2 format)
  - `registrationNumber` string, required
  - `incorporatedOn` BusinessIncorporatedDate
    - `year` integer, required
    - `month` integer, required
    - `day` integer, required
  - `legalAddress` Address
    - `addressLine1` string, required — The first line of the address. A string up to 80 characters in length, containing only valid Latin characters (a-z, A-Z).
    - `addressLine2` string — The first line of the address. A string up to 80 characters in length, containing only valid Latin characters (a-z, A-Z).
    - `city` string, required — The city of the address. A string up to 40 characters in length, containing only valid Latin characters (a-z, A-Z).
    - `postalCode` string, required — The postal code - A string up to 20 characters in length
    - `state` string — A string 3-80 characters in length, containing only valid Latin characters (a-z, A-Z).
    - `country` string, ISO31661Alpha2, required — The country of the address expressed in ISO 3166-1 alpha-2 format.
  - `entityType` 'LIMITED_LIABILITY_COMPANY' | 'PUBLICLY_LISTED_COMPANY' | 'SOLE_PROPRIETOR' | 'PARTNERSHIP' | 'CORPORATION' | 'TRUST' | 'PRIVATE_FOUNDATION' | 'CHARITY' | 'NONPROFIT_ORGANIZATION' — A type of legal entity
  - `primaryUser` BusinessPrimaryUserResponse, required — Should be a registered director
    - `firstName` string, required — First name of the primary user
    - `lastName` string, required — Last name of the primary user
    - `email` string, email, required — E-mail address of the primary user
    - `mobile` Mobile, required — The mobile number of the primary user
      - `countryCode` string, required — The country code of the user mobile number (e.g. +44). Must contain a '+'
      - `number` string, required — The mobile number of the primary user - excluding country code. Up to 12 digits in length
  - `KYB` KYBStatusResponse, required — KYB creation status
    - `emailVerified` boolean
    - `mobileVerified` boolean
    - `status` 'NOT_STARTED' | 'INITIATED' | 'PENDING_REVIEW' | 'ON_HOLD' | 'APPROVED' | 'REJECTED' | 'REJECTED_FINAL' — Verification Status
  - `missingFields` string[]
  - `emailVerification` object
    - `dateExpires` string, date-time — RFC 3339 format
  - `mobileVerification` object
    - `dateExpires` string, date-time — RFC 3339 format
  - `outboundLimitAllowed` string — Outbound limit allowed
  - `outboundLimitConsumed` string — Outbound limit consumed

## Other responses

- `400` — Bad Request. The request was unacceptable, often due to missing a required parameter.
- `401` — Invalid authentication header
- `404` — Business not found by primary user email
- `500` — Unexpected server error.

---

[API](https://skmtc.net/striga/apis/striga-v1.md) · [All operations](https://skmtc.net/striga/apis/striga-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/striga/striga-v1/revisions/63e57aa7df45/schema)