Salesforce Field API

The Field API from Salesforce — 4 operation(s) for field.

Operations 3

GET /data/v64.0/ui-api/object-info/{SOBJECT_API_NAME}/picklist-values/{RECORD_TYPE_ID}/{FIELD_API_NAME} Salesforce Get Values for a Picklist Field #
GET /data/v64.0/ui-api/lookups/{SOBJECT_API_NAME}/{FIELD_API_NAME} Salesforce Get Lookup Field Suggestions #
GET /data/v64.0/ui-api/lookups/{SOBJECT_API_NAME}/{FIELD_API_NAME}/{TARGET_API_NAME} Salesforce Get Lookup Field Suggestions for a Specified Object #

Documentation

Specifications

Schemas & Data

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/salesforce-field-api"
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 email required.

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

OpenAPI Specification

salesforce-field-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Salesforce Field API
  description: 'Find the resources you need to start building. '
  contact: {}
  version: '1.0'
servers:
- url: https://login.salesforce.com
  variables: {}
- url: https://id
  variables: {}
- url: https://services
  variables: {}
- url: '{{url}}{{site}}/services/oauth2'
  variables:
    url:
      default: DefaultParameterValue
    site:
      default: DefaultParameterValue
security:
- oauth2:
  - api
tags:
- name: Field
paths:
  /data/v64.0/ui-api/object-info/{SOBJECT_API_NAME}/picklist-values/{RECORD_TYPE_ID}/{FIELD_API_NAME}:
    parameters: []
    get:
      tags:
      - Field
      summary: Salesforce Get Values for a Picklist Field
      description: Get metadata about a specific object. The response includes metadata describing fields, child relationships, record type, and theme.
      operationId: GetValuesforaPicklistField
      parameters:
      - name: SOBJECT_API_NAME
        in: path
        description: Object API Name
        required: true
        schema:
          type: string
          examples:
          - Account
        example: example_value
      - name: RECORD_TYPE_ID
        in: path
        description: Record type Id. Use `012000000000000AAA` as default when there are no custom record types.
        required: true
        schema:
          type: string
          examples:
          - 012000000000000AAA
        example: '500123'
      - name: FIELD_API_NAME
        in: path
        description: Field API Name (optional)
        required: true
        schema:
          type: string
          examples:
          - Industry
        example: example_value
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Tue, 04 May 2021 09:32:34 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=31536002; includeSubDomains
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '"bee3e6401e143e18332a17639061c5ff--gzip"'
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/GetValuesforaPicklistField'
                - examples:
                  - controllerValues: {}
                    defaultValue: null
                    eTag: bee3e6401e143e18332a17639061c5ff
                    url: /services/data/v51.0/ui-api/object-info/Account/picklist-values/012000000000000AAA/Industry
                    values:
                    - attributes: null
                      label: Agriculture
                      validFor: []
                      value: Agriculture
                    - attributes: null
                      label: Apparel
                      validFor: []
                      value: Apparel
                    - attributes: null
                      label: Banking
                      validFor: []
                      value: Banking
                    - attributes: null
                      label: Biotechnology
                      validFor: []
                      value: Biotechnology
                    - attributes: null
                      label: Chemicals
                      validFor: []
                      value: Chemicals
                    - attributes: null
                      label: Communications
                      validFor: []
                      value: Communications
                    - attributes: null
                      label: Construction
                      validFor: []
                      value: Construction
                    - attributes: null
                      label: Consulting
                      validFor: []
                      value: Consulting
                    - attributes: null
                      label: Education
                      validFor: []
                      value: Education
                    - attributes: null
                      label: Electronics
                      validFor: []
                      value: Electronics
                    - attributes: null
                      label: Energy
                      validFor: []
                      value: Energy
                    - attributes: null
                      label: Engineering
                      validFor: []
                      value: Engineering
                    - attributes: null
                      label: Entertainment
                      validFor: []
                      value: Entertainment
                    - attributes: null
                      label: Environmental
                      validFor: []
                      value: Environmental
                    - attributes: null
                      label: Finance
                      validFor: []
                      value: Finance
                    - attributes: null
                      label: Food & Beverage
                      validFor: []
                      value: Food & Beverage
                    - attributes: null
                      label: Government
                      validFor: []
                      value: Government
                    - attributes: null
                      label: Healthcare
                      validFor: []
                      value: Healthcare
                    - attributes: null
                      label: Hospitality
                      validFor: []
                      value: Hospitality
                    - attributes: null
                      label: Insurance
                      validFor: []
                      value: Insurance
                    - attributes: null
                      label: Machinery
                      validFor: []
                      value: Machinery
                    - attributes: null
                      label: Manufacturing
                      validFor: []
                      value: Manufacturing
                    - attributes: null
                      label: Media
                      validFor: []
                      value: Media
                    - attributes: null
                      label: Not For Profit
                      validFor: []
                      value: Not For Profit
                    - attributes: null
                      label: Recreation
                      validFor: []
                      value: Recreation
                    - attributes: null
                      label: Retail
                      validFor: []
                      value: Retail
                    - attributes: null
                      label: Shipping
                      validFor: []
                      value: Shipping
                    - attributes: null
                      label: Technology
                      validFor: []
                      value: Technology
                    - attributes: null
                      label: Telecommunications
                      validFor: []
                      value: Telecommunications
                    - attributes: null
                      label: Transportation
                      validFor: []
                      value: Transportation
                    - attributes: null
                      label: Utilities
                      validFor: []
                      value: Utilities
                    - attributes: null
                      label: Other
                      validFor: []
                      value: Other
                contentMediaType: application/json;charset=UTF-8
              example:
                controllerValues: {}
                defaultValue: null
                eTag: bee3e6401e143e18332a17639061c5ff
                url: /services/data/v51.0/ui-api/object-info/Account/picklist-values/012000000000000AAA/Industry
                values:
                - attributes: null
                  label: Agriculture
                  validFor: []
                  value: Agriculture
                - attributes: null
                  label: Apparel
                  validFor: []
                  value: Apparel
                - attributes: null
                  label: Banking
                  validFor: []
                  value: Banking
                - attributes: null
                  label: Biotechnology
                  validFor: []
                  value: Biotechnology
                - attributes: null
                  label: Chemicals
                  validFor: []
                  value: Chemicals
                - attributes: null
                  label: Communications
                  validFor: []
                  value: Communications
                - attributes: null
                  label: Construction
                  validFor: []
                  value: Construction
                - attributes: null
                  label: Consulting
                  validFor: []
                  value: Consulting
                - attributes: null
                  label: Education
                  validFor: []
                  value: Education
                - attributes: null
                  label: Electronics
                  validFor: []
                  value: Electronics
                - attributes: null
                  label: Energy
                  validFor: []
                  value: Energy
                - attributes: null
                  label: Engineering
                  validFor: []
                  value: Engineering
                - attributes: null
                  label: Entertainment
                  validFor: []
                  value: Entertainment
                - attributes: null
                  label: Environmental
                  validFor: []
                  value: Environmental
                - attributes: null
                  label: Finance
                  validFor: []
                  value: Finance
                - attributes: null
                  label: Food & Beverage
                  validFor: []
                  value: Food & Beverage
                - attributes: null
                  label: Government
                  validFor: []
                  value: Government
                - attributes: null
                  label: Healthcare
                  validFor: []
                  value: Healthcare
                - attributes: null
                  label: Hospitality
                  validFor: []
                  value: Hospitality
                - attributes: null
                  label: Insurance
                  validFor: []
                  value: Insurance
                - attributes: null
                  label: Machinery
                  validFor: []
                  value: Machinery
                - attributes: null
                  label: Manufacturing
                  validFor: []
                  value: Manufacturing
                - attributes: null
                  label: Media
                  validFor: []
                  value: Media
                - attributes: null
                  label: Not For Profit
                  validFor: []
                  value: Not For Profit
                - attributes: null
                  label: Recreation
                  validFor: []
                  value: Recreation
                - attributes: null
                  label: Retail
                  validFor: []
                  value: Retail
                - attributes: null
                  label: Shipping
                  validFor: []
                  value: Shipping
                - attributes: null
                  label: Technology
                  validFor: []
                  value: Technology
                - attributes: null
                  label: Telecommunications
                  validFor: []
                  value: Telecommunications
                - attributes: null
                  label: Transportation
                  validFor: []
                  value: Transportation
                - attributes: null
                  label: Utilities
                  validFor: []
                  value: Utilities
                - attributes: null
                  label: Other
                  validFor: []
                  value: Other
      deprecated: false
      servers:
      - url: https://services
        variables: {}
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /data/v64.0/ui-api/lookups/{SOBJECT_API_NAME}/{FIELD_API_NAME}:
    parameters: []
    get:
      tags:
      - Field
      summary: Salesforce Get Lookup Field Suggestions
      description: When a user edits a lookup field, use this resource to search for and display suggestions. You can search for most recently used matches, for matching names, or for any match in a searchable field. You can also specify lookup filter bindings for dependent lookups.
      operationId: GetLookupFieldSuggestions
      parameters:
      - name: SOBJECT_API_NAME
        in: path
        description: sObject API name
        required: true
        schema:
          type: string
        example: example_value
      - name: FIELD_API_NAME
        in: path
        description: Field API name
        required: true
        schema:
          type: string
        example: example_value
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Wed, 27 Sep 2023 16:07:13 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=63072000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 1; mode=block
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/GetLookupFieldSuggestions'
                - examples:
                  - lookupResults:
                      Account:
                        count: 2
                        currentPageToken: null
                        currentPageUrl: /services/data/v58.0/ui-api/lookups/Contact/AccountId/Account?searchType=Recent&page=1&pageSize=25
                        nextPageToken: null
                        nextPageUrl: null
                        previousPageToken: null
                        previousPageUrl: null
                        records:
                        - apiName: Account
                          childRelationships: {}
                          eTag: 610a250509b966f2eb376b3205824a8b
                          fields:
                            Id:
                              displayValue: null
                              value: 001B000000UnQ2yIAF
                            Name:
                              displayValue: null
                              value: Dickenson plc
                            Site:
                              displayValue: null
                              value: null
                          id: 001B000000UnQ2yIAF
                          lastModifiedById: 005B0000003TOI6IAO
                          lastModifiedDate: '2017-08-18T14:46:22.000Z'
                          recordTypeId: 012000000000000AAA
                          recordTypeInfo: null
                          systemModstamp: '2017-08-18T14:46:22.000Z'
                          weakEtag: 1503067582000
                        - apiName: Account
                          childRelationships: {}
                          eTag: d0b7cec61a65e01f88b2596dea75cbd8
                          fields:
                            Id:
                              displayValue: null
                              value: 001B000000UnQ2wIAF
                            Name:
                              displayValue: null
                              value: Burlington Textiles Corp of America
                            Site:
                              displayValue: null
                              value: null
                          id: 001B000000UnQ2wIAF
                          lastModifiedById: 005B0000003TOI6IAO
                          lastModifiedDate: '2017-08-18T14:46:22.000Z'
                          recordTypeId: 012000000000000AAA
                          recordTypeInfo: null
                          systemModstamp: '2017-08-18T14:46:22.000Z'
                          weakEtag: 1503067582000
                    metadata:
                      Account:
                        fieldApiName: null
                        objectApiName: null
                        secondaryField: Site
                        targetInfo: {}
                contentMediaType: application/json;charset=UTF-8
              example:
                lookupResults:
                  Account:
                    count: 2
                    currentPageToken: null
                    currentPageUrl: /services/data/v58.0/ui-api/lookups/Contact/AccountId/Account?searchType=Recent&page=1&pageSize=25
                    nextPageToken: null
                    nextPageUrl: null
                    previousPageToken: null
                    previousPageUrl: null
                    records:
                    - apiName: Account
                      childRelationships: {}
                      eTag: 610a250509b966f2eb376b3205824a8b
                      fields:
                        Id:
                          displayValue: null
                          value: 001B000000UnQ2yIAF
                        Name:
                          displayValue: null
                          value: Dickenson plc
                        Site:
                          displayValue: null
                          value: null
                      id: 001B000000UnQ2yIAF
                      lastModifiedById: 005B0000003TOI6IAO
                      lastModifiedDate: '2017-08-18T14:46:22.000Z'
                      recordTypeId: 012000000000000AAA
                      recordTypeInfo: null
                      systemModstamp: '2017-08-18T14:46:22.000Z'
                      weakEtag: 1503067582000
                    - apiName: Account
                      childRelationships: {}
                      eTag: d0b7cec61a65e01f88b2596dea75cbd8
                      fields:
                        Id:
                          displayValue: null
                          value: 001B000000UnQ2wIAF
                        Name:
                          displayValue: null
                          value: Burlington Textiles Corp of America
                        Site:
                          displayValue: null
                          value: null
                      id: 001B000000UnQ2wIAF
                      lastModifiedById: 005B0000003TOI6IAO
                      lastModifiedDate: '2017-08-18T14:46:22.000Z'
                      recordTypeId: 012000000000000AAA
                      recordTypeInfo: null
                      systemModstamp: '2017-08-18T14:46:22.000Z'
                      weakEtag: 1503067582000
                metadata:
                  Account:
                    fieldApiName: null
                    objectApiName: null
                    secondaryField: Site
                    targetInfo: {}
      deprecated: false
      servers:
      - url: https://services
        variables: {}
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /data/v64.0/ui-api/lookups/{SOBJECT_API_NAME}/{FIELD_API_NAME}/{TARGET_API_NAME}:
    parameters: []
    get:
      tags:
      - Field
      summary: Salesforce Get Lookup Field Suggestions for a Specified Object
      description: When a user edits a lookup field, use this resource to search for and display suggestions for a specified object. You can search for most recently used matches, for matching names, or for any match in a searchable field. You can also specify lookup filter bindings for dependent lookups.
      operationId: GetLookupFieldSuggestionsforaSpecifiedObject
      parameters:
      - name: SOBJECT_API_NAME
        in: path
        description: The API name of a source object.
        required: true
        schema:
          type: string
        example: example_value
      - name: FIELD_API_NAME
        in: path
        description: The API name of a lookup field on the source object.
        required: true
        schema:
          type: string
        example: example_value
      - name: TARGET_API_NAME
        in: path
        description: The API name of the target (lookup) object.
        required: true
        schema:
          type: string
        example: example_value
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Wed, 27 Sep 2023 16:10:07 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=63072000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 1; mode=block
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/GetLookupFieldSuggestionsforaSpecifiedObject'
                - examples:
                  - count: 2
                    currentPageToken: null
                    currentPageUrl: /services/data/v58.0/ui-api/lookups/Contact/AccountId/Account?searchType=Recent&page=1&pageSize=25
                    nextPageToken: null
                    nextPageUrl: null
                    previousPageToken: null
                    previousPageUrl: null
                    records:
                    - apiName: Account
                      childRelationships: {}
                      eTag: 2316c5f4a27ac31b407d91aab610b281
                      fields:
                        DisambiguationField:
                          displayValue: null
                          value: null
                        Id:
                          displayValue: null
                          value: 001B000000UnQ2yIAF
                        Name:
                          displayValue: null
                          value: Dickenson plc
                        Site:
                          displayValue: null
                          value: null
                      id: 001B000000UnQ2yIAF
                      lastModifiedById: 005B0000003TOI6IAO
                      lastModifiedDate: '2017-08-18T14:46:22.000Z'
                      recordTypeId: 012000000000000AAA
                      recordTypeInfo: null
                      systemModstamp: '2017-08-18T14:46:22.000Z'
                      weakEtag: 1503067582000
                    - apiName: Account
                      childRelationships: {}
                      eTag: cb5afb4494d9c9f6f81ab0e5f214585c
                      fields:
                        DisambiguationField:
                          displayValue: null
                          value: null
                        Id:
                          displayValue: null
                          value: 001B000000UnQ2wIAF
                        Name:
                          displayValue: null
                          value: Burlington Textiles Corp of America
                        Site:
                          displayValue: null
                          value: null
                      id: 001B000000UnQ2wIAF
                      lastModifiedById: 005B0000003TOI6IAO
                      lastModifiedDate: '2017-08-18T14:46:22.000Z'
                      recordTypeId: 012000000000000AAA
                      recordTypeInfo: null
                      systemModstamp: '2017-08-18T14:46:22.000Z'
                      weakEtag: 1503067582000
                contentMediaType: application/json;charset=UTF-8
              example:
                count: 2
                currentPageToken: null
                currentPageUrl: /services/data/v58.0/ui-api/lookups/Contact/AccountId/Account?searchType=Recent&page=1&pageSize=25
                nextPageToken: null
                nextPageUrl: null
                previousPageToken: null
                previousPageUrl: null
                records:
                - apiName: Account
                  childRelationships: {}
                  eTag: 2316c5f4a27ac31b407d91aab610b281
                  fields:
                    DisambiguationField:
                      displayValue: null
                      value: null
                    Id:
                      displayValue: null
                      value: 001B000000UnQ2yIAF
                    Name:
                      displayValue: null
                      value: Dickenson plc
                    Site:
                      displayValue: null
                      value: null
                  id: 001B000000UnQ2yIAF
                  lastModifiedById: 005B0000003TOI6IAO
                  lastModifiedDate: '2017-08-18T14:46:22.000Z'
                  recordTypeId: 012000000000000AAA
                  recordTypeInfo: null
                  systemModstamp: '2017-08-18T14:46:22.000Z'
                  weakEtag: 1503067582000
                - apiName: Account
                  childRelationships: {}
                  eTag: cb5afb4494d9c9f6f81ab0e5f214585c
                  fields:
                    DisambiguationField:
                      displayValue: null
                      value: null
                    Id:
                      displayValue: null
                      value: 001B000000UnQ2wIAF
                    Name:
                      displayValue: null
                      value: Burlington Textiles Corp of America
                    Site:
                      displayValue: null
                      value: null
                  id: 001B000000UnQ2wIAF
                  lastModifiedById: 005B0000003TOI6IAO
                  lastModifiedDate: '2017-08-18T14:46:22.000Z'
                  recordTypeId: 012000000000000AAA
                  recordTypeInfo: null
                  systemModstamp: '2017-08-18T14:46:22.000Z'
                  weakEtag: 1503067582000
      deprecated: false
      servers:
      - url: https://services
        variables: {}
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    Id8:
      title: Id8
      required:
      - displayValue
      - value
      type: object
      properties:
        displayValue:
          type:
          - string
          - 'null'
          example: example_value
        value:
          type: string
          example: example_value
      examples:
      - displayValue: null
        value: 005B0000003TOI6IAO
    Name21:
      title: Name21
      required:
      - displayValue
      - value
      type: object
      properties:
        displayValue:
          type:
          - string
          - 'null'
          example: example_value
        value:
          type: string
          example: example_value
      examples:
      - displayValue: null
        value: Philippe Ozil
    Value6:
      title: Value6
      required:
      - attributes
      - label
      - validFor
      - value
      type: object
      properties:
        attributes:
          type:
          - string
 

# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/salesforce/refs/heads/main/openapi/salesforce-field-api-openapi.yml