Member Search

The Member Search API enables employers and payroll software providers to efficiently search and retrieve details of employees enrolled in the YIP Scheme.

(Please see Sovereign OpenAPI documentation for detailed schema)

Searching for Employees

To find employees using the Employee Search API, submit a request with the desired search criteria:

GET Request URL

https://api.yip.services/v1.0/employees/{social_security_no}

The API response will be a JSON object containing the details of the employee matching the search criteria.

Example Response:

application/json

{
    "personalDetails": {
        "fullName": "Ms Lesli Hickman",
        "gender": "Female",
        "dateOfBirth": "1999-08-26",
        "countryOfBirth": "Guernsey",
        "nationality": "Guernsey"
    },
    "pensionDetails": {
        "planName": "Your Island Pension",
        "status": "Active",
        "dateJoinedPlan": "2020-04-04"
    },
    "employerDetails": {
        "employer": "Plumbing Limited",
        "startDate": "2016-06-18"
    }
}

If no employee is found for the given social security number, the API responds with a 404 status and a member_not_found error:

application/json

{
    "success": false,
    "errors": [
        {
            "error": "member_not_found",
            "message": "Member by the GY502564 social security number could not be found...",
            "detail": "",
            "sovtraceID": "b8702cd8-6e8c-4df6-b272-f4445c1d7edc"
        }
    ]
}

---

Last update: July 30, 2026
Created: February 11, 2025