First American Financial

First American Income Estimate API

Income estimate (SalaryComp) service returning a salary comparison for a named employer. Swagger 2.0, 2 operations.

Documentation GitHub OpenAPI

Operations 2

POST /salarycomp/order Make a new Income Estimate service call #

GET /salarycomp/report Retrieve existing Income Estimate report by transactionID #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/first-american-financial-income-estimate"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

swagger: '2.0'
info:
  description: ''
  version: v1
  title: Income Estimate API
host: api.firstam.io
basePath: /v1
tags:
- name: developers
  description: Operations available to regular developers
schemes:
- https
paths:
  /salarycomp/order:
    post:
      tags:
      - Request
      summary: Make a new Income Estimate service call
      description: 'Required fields: RequestorID, Employer.'
      operationId: post
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: ServiceRequest
        description: Request to the Service
        required: true
        schema:
          $ref: '#/definitions/ServiceRequest'
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/ServiceResponse'
        '400':
          description: Bad Request
        '401':
          description: Invalid App ID or Key
        '500':
          description: Internal Server Error
        '503':
          description: Usage Limit Exceeded
  /salarycomp/report:
    get:
      tags:
      - Get Response
      summary: Retrieve existing Income Estimate report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report.
      operationId: get
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - name: transactionID
        in: query
        description: Unique Identifier Tied To a Report
        required: true
        type: string
      responses:
        '200':
          description: Success
          schema:
            $ref: '#/definitions/ServiceResponse'
        '400':
          description: Bad Request (Missing/Invalid TransactionID)
        '401':
          description: Invalid App ID or Key
        '404':
          description: Not Found (No Report Found by TransactionID)
        '500':
          description: Internal Server Error
        '503':
          description: Usage Limit Exceeded
definitions:
  ServiceRequest:
    type: object
    required:
    - RequestorID
    - Employer
    properties:
      RequestorID:
        type: string
      Individual:
        $ref: '#/definitions/IndividualRequest'
      Employer:
        $ref: '#/definitions/EmployerRequest'
      Location:
        $ref: '#/definitions/LocationRequest'
      Income:
        $ref: '#/definitions/IncomeRequest'
    example:
      RequestorID: ID123
      Employer:
        Title: engineer
        YearsOnJob: 10
        YearsWithEmployer: 0
        YearsExperience: 0
      Income:
        BaseAnnualIncome: 144000
        Overtime: 0
        Bonus: 0
        Commissions: 0
  ServiceResponse:
    type: object
    properties:
      TransactionID:
        type: string
      RequestorID:
        type: string
      Error:
        type: string
      Result:
        $ref: '#/definitions/Result'
  IndividualRequest:
    type: object
    properties:
      DateOfBirth:
        type: string
  EmployerRequest:
    type: object
    properties:
      Name:
        type: string
      Title:
        type: string
      YearsOnJob:
        type: integer
      YearsWithEmployer:
        type: integer
      YearsExperience:
        type: integer
      EmployerType:
        type: string
  LocationRequest:
    type: object
    properties:
      Country:
        type: string
      State:
        type: string
      City:
        type: integer
  IncomeRequest:
    type: object
    properties:
      BaseAnnualIncome:
        type: integer
      Overtime:
        type: integer
      Bonus:
        type: integer
      Commissions:
        type: integer
  Result:
    type: object
    properties:
      MatchingJobs:
        description: 'Jobs Matching  '
        type: array
        items:
          type: string
      OverstatedCompScore:
        type: integer
        description: 'OverstatedCompScore '
      TargetCompensation:
        type: integer
        description: 'TargetCompensation  '
      Percentile25:
        type: integer
        description: 'Percentile25 '
      Median:
        type: integer
        description: 'Median '
      Percentile75:
        type: integer
        description: 'Percentile75  '