Get Talent Group

Gets a list of talent pool groups. From the Field Nation Platform, you can access this information from the Workforce > Talent section.

URLs

Environment Method URL
Sandbox https://api-sandbox.fndev.net/api/rest/v2/company/preferred-providers
Production https://api.fieldnation.com/api/rest/v2/company/preferred-providers

Path Parameters

Not applicable.

Query Parameters

Parameter Type Example Notes
access_token string abc123defg459hijk786lmn45 Required.

Body

Not applicable.

Response

Returns Talent Pool groups and the number of providers in each group.

Examples

{
    "actions": [],
    "metadata": {
        "total": 2,
        "page": 1,
        "pages": 1,
        "per_page": 5000,
        "columns": "name:400,providers:175,:0,actions:175,correlation_id:175",
        "view": "list",
        "sort": "",
        "order": "asc",
        "available_columns": [],
        "available_filters": []
    },
    "params": [],
    "results": [
        {
            "id": 99999999,
            "actions": [],
            "correlation_id": "f4aaf82a0a60b5d5912046e112310e3e295f4f0b",
            "name": "Uncategorized",
            "providers": 2
        },
        {
            "id": 13,
            "actions": [
                "edit",
                "delete"
            ],
            "correlation_id": "54c7d028038ed00a3a80cab287cc11a2d051d86a",
            "name": "ATM Repair",
            "providers": 0
        }
    ]
}

Errors

Standard HTTP and OAuth error codes.