Field NationDeveloper Platform
Field NationDeveloper Platform
IntroductionQuick StartAPI Playground

Getting Started

API Reference

People

UsersProvidersTalent PoolsTalent Pool GroupsService Territories

Organization

ClientsProjectsLocations

Configuration

TemplatesTypes of WorkCompany
Resources

Providers

Finding and working with service providers in the marketplace.


Providers

The power of Field Nation is the network of skilled technicians (providers).

Provider Organization

Loading diagram...

Finding Providers

You generally do not "search" for providers by name in the API to route to them blindly. Instead, you utilize Talent Pools and Talent Pool Groups.

Marketplace Access

Providers are automatically matched to your work orders based on:

  • Location proximity
  • Skills and qualifications
  • Ratings and past performance
  • Availability

Direct Provider Lookup

If you know a provider's ID (from a previous work order), you can look them up:

GET /users/{user_id}

{
  "id": 25,
  "first_name": "Sarah",
  "last_name": "Johnson",
  "rating": 4.9,
  "jobs_completed": 342,
  "certifications": ["CompTIA A+", "BICSI"]
}

Routing to Providers

Mass Route to Talent Pool

Route a work order to all providers in a talent pool:

POST /workorders/{work_order_id}/mass-route

{
  "talent_pool_id": 9921
}

Direct Assignment

Assign a specific provider to a work order:

POST /workorders/{work_order_id}/assignee

{
  "user": { "id": 12345 }
}

Provider Selection

When providers are routed a work order, they can:

  1. Request - Express interest with optional counter-offer
  2. Accept - Accept as-is (if auto-assign is enabled)
  3. Decline - Pass on the opportunity

Best Practice: Build curated Talent Pools in the Field Nation UI, then reference them by ID in your API integration for consistent routing.

Related Resources

  • Users - User details and profiles
  • Talent Pools - Individual pools of providers
  • Talent Pool Groups - Collections of talent pools

Last updated on

Users

Retrieve user details and profiles.

Talent Pools

Individual talent pools containing providers with custom attributes.

On this page

Providers
Provider Organization
Finding Providers
Marketplace Access
Direct Provider Lookup
Routing to Providers
Mass Route to Talent Pool
Direct Assignment
Provider Selection
Related Resources