---
title: "Social Security System (SSS) Verification"
method: POST
path: "/philippines/sss/verify"
tags: ["Social Security System (SSS)"]
---

# Social Security System (SSS) Verification

`POST /philippines/sss/verify`

## Request

- Base URL: `https://api.verihubs.com`
- URL: `https://api.verihubs.com/philippines/sss/verify`
- Auth: none declared. Required headers: `App-ID`, `API-Key`

This method helps you to verify a Philippine Social Security System (SSS) number against the legal source.

#### Request Notes
- `card_no` is the SSS number, 10 or 12 characters, numeric only (no dashes or spaces).
- `reference_id` is optional. When it is empty, a UUID is generated and returned in the response. It must be unique per service: reusing a `reference_id` returns `Transaction already created for this reference_id`.

## Headers

- `App-ID` string, required
- `API-Key` string, required

## Request body

- SSSVerification
  - `card_no` string, required: SSS number, 10 or 12 characters, numeric only.
  - `reference_id` string: Use to indicate your company's transaction (must be unique). When empty, a UUID is generated.

## Response `200`

Successful Response

- ResponseSSSVerification
  - `message` string, required: Shows message of the response.
  - `data` object, required
    - `card_no` boolean: SSS number verification result. Returns `true` when the number is verified, `false` when it is not.
    - `reference_id` string: Reference id of the transaction, the same value you sent (or a generated UUID if it was empty).
    - `transaction_id` string: Verihubs ID, generated string that is unique for every transaction.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/verihubs/apis/philippines-api-documentation.md) - [All operations](https://skmtc.dev/verihubs/apis/philippines-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/verihubs/apis/philippines-api-documentation/revisions/0659a8e15437?raw)