---
title: "Fuzzy search employers and return employers' basic information"
method: GET
path: "/alpha/employerBasics/query"
tags: ["Employers"]
---

# Fuzzy search employers and return employers' basic information

`GET /alpha/employerBasics/query`

## Query parameters

- `keyword` string

## Response `200`

OK

- EmployerBasicQueryResponse
  - `code` 'OK' | 'CREATED' | 'INVALID_CREDENTIALS' | 'INVALID_PARAMETERS' | 'INVALID_TOKEN' | 'UNAUTHORIZED_ACCESS' | 'MISSING_RESOURCE' | 'REQUEST_LIMIT_EXCEEDED' | 'SERVER_ERROR' | 'UNSUPPORTED_METHOD' | 'SERVER_UNAVAILABLE' | 'TIME_LIMIT_EXCEEDED' — Request status code
  - `message` string — Message response to the request
  - `requestId` string — Unique ID that is added to the body of every response for easy traceability of the request in our logs.
  - `data` EmployerBasic[]
    - `businessName` string — Business Name
    - `registrations` EmployerRegistration[]
      - `number` string, required — Registration Number
      - `organization` string, required — Registering body or organization
      - `date` string, date — The date, yyyy-MM-dd
      - `scope` string — Registration Scope
      - `status` 'Registered' | 'Suspended' | 'Revoked' | 'Dissolved' | 'Delinquent' — Registration Status
    - `matchPercentage` integer — Match Percentage, 100 = exact match, 0 = no match.
    - `sources` EmployerSource[]
    - `verificationStatus` 'VERIFIED' | 'UNVERIFIED' — Verification Status. If the data source is an authoritative source, the status will be VERIFIED. Otherwise, UNVERIFIED.

---

[API](https://skmtc.net/smileapi/apis/smile-api.md) · [All operations](https://skmtc.net/smileapi/apis/smile-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smileapi/smile-api/versions/d1e0cb5dc33c/schema)