Salesforce Values API

The Values API from Salesforce — 4 operation(s) for values.

Documentation

Specifications

Schemas & Data

OpenAPI Specification

salesforce-values-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Salesforce Bulk API 2.0 Abort Values API
  description: 'Salesforce Bulk API 2.0 is a simplified, REST-based interface for bulk data operations that improves on the original Bulk API. It uses a straightforward job model and supports CSV format for ingest and query jobs, enabling processing of millions of records asynchronously.

    '
  version: v63.0
  contact:
    name: Salesforce Developers
    url: https://developer.salesforce.com/
  license:
    name: Salesforce Developer Terms
    url: https://www.salesforce.com/company/legal/agreements/
servers:
- url: https://{instance}.salesforce.com/services/data/v{version}/jobs
  description: Salesforce Bulk API 2.0 jobs endpoint
  variables:
    instance:
      default: yourInstance
      description: 'The Salesforce instance identifier (e.g., na1, eu3, or a My Domain subdomain like mycompany).

        '
    version:
      default: '63.0'
      description: 'The Salesforce API version number (e.g., 63.0). Use the latest supported version for new integrations.

        '
security:
- BearerAuth: []
tags:
- name: Values
paths:
  /data/v64.0/ui-api/object-info/{SOBJECT_API_NAME}/picklist-values/{RECORD_TYPE_ID}/{FIELD_API_NAME}:
    parameters: []
    get:
      tags:
      - Values
      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/object-info/{SOBJECT_API_NAME}/picklist-values/{RECORD_TYPE_ID}:
    parameters: []
    get:
      tags:
      - Values
      summary: Salesforce Get Values for All Picklist Fields of a Record Type
      description: Get metadata about a specific object. The response includes metadata describing fields, child relationships, record type, and theme.
      operationId: GetValuesforAllPicklistFieldsofaRecordType
      parameters:
      - name: SOBJECT_API_NAME
        in: path
        description: Object API Name
        required: true
        schema:
          type: string
        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
        example: '500123'
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Wed, 27 Sep 2023 15:55:22 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
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '"ef21257ca08f8952ff154f57dc775336--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/GetValuesforAllPicklistFieldsofaRecordType'
                - examples:
                  - eTag: ef21257ca08f8952ff154f57dc775336
                    picklistFieldValues:
                      CleanStatus:
                        controllerValues: {}
                        defaultValue: null
                        eTag: bd535d2876948d8bb91fad409b69e359
                        url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/CleanStatus
                        values:
                        - attributes: null
                          label: In Sync
                          validFor: []
                          value: Matched
                        - attributes: null
                          label: Different
                          validFor: []
                          value: Different
                        - attributes: null
                          label: Reviewed
                          validFor: []
                          value: Acknowledged
                        - attributes: null
                          label: Not Found
                          validFor: []
                          value: NotFound
                        - attributes: null
                          label: Inactive
                          validFor: []
                          value: Inactive
                        - attributes: null
                          label: Not Compared
                          validFor: []
                          value: Pending
                        - attributes: null
                          label: Select Match
                          validFor: []
                          value: SelectMatch
                        - attributes: null
                          label: Skipped
                          validFor: []
                          value: Skipped
                      LeadSource:
                        controllerValues: {}
                        defaultValue: null
                        eTag: edb5c49da4ff7bfe2cf15ecae67a306c
                        url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/LeadSource
                        values:
                        - attributes: null
                          label: Web
                          validFor: []
                          value: Web
                        - attributes: null
                          label: Phone Inquiry
                          validFor: []
                          value: Phone Inquiry
                        - attributes: null
                          label: Partner Referral
                          validFor: []
                          value: Partner Referral
                        - attributes: null
                          label: Purchased List
                          validFor: []
                          value: Purchased List
                        - attributes: null
                          label: Other
                          validFor: []
                          value: Other
                      Level__c:
                        controllerValues: {}
                        defaultValue: null
                        eTag: ffef8adfed014c3057fd14658f5202c4
                        url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/Level__c
                        values:
                        - attributes: null
                          label: Secondary
                          validFor: []
                          value: Secondary
                        - attributes: null
                          label: Tertiary
                          validFor: []
                          value: Tertiary
                        - attributes: null
                          label: Primary
                          validFor: []
                          value: Primary
                      MailingGeocodeAccuracy:
                        controllerValues: {}
                        defaultValue: null
                        eTag: 776a2f5e98c411bafb45081e39a6f1ec
                        url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/MailingGeocodeAccuracy
                        values:
                        - attributes: null
                          label: Address
                          validFor: []
                          value: Address
                        - attributes: null
                          label: NearAddress
                          validFor: []
                          value: NearAddress
                        - attributes: null
                          label: Block
                          validFor: []
                          value: Block
                        - attributes: null
                          label: Street
                          validFor: []
                          value: Street
                        - attributes: null
                          label: ExtendedZip
                          validFor: []
                          value: ExtendedZip
                        - attributes: null
                          label: Zip
                          validFor: []
                          value: Zip
                        - attributes: null
                          label: Neighborhood
                          validFor: []
                          value: Neighborhood
                        - attributes: null
                          label: City
                          validFor: []
                          value: City
                        - attributes: null
                          label: County
                          validFor: []
                          value: County
                        - attributes: null
                          label: State
                          validFor: []
                          value: State
                        - attributes: null
                          label: Unknown
                          validFor: []
                          value: Unknown
                      OtherGeocodeAccuracy:
                        controllerValues: {}
                        defaultValue: null
                        eTag: 776a2f5e98c411bafb45081e39a6f1ec
                        url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/OtherGeocodeAccuracy
                        values:
                        - attributes: null
                          label: Address
                          validFor: []
                          value: Address
                        - attributes: null
                          label: NearAddress
                          validFor: []
                          value: NearAddress
                        - attributes: null
                          label: Block
                          validFor: []
                          value: Block
                        - attributes: null
                          label: Street
                          validFor: []
                          value: Street
                        - attributes: null
                          label: ExtendedZip
                          validFor: []
                          value: ExtendedZip
                        - attributes: null
                          label: Zip
                          validFor: []
                          value: Zip
                        - attributes: null
                          label: Neighborhood
                          validFor: []
                          value: Neighborhood
                        - attributes: null
                          label: City
                          validFor: []
                          value: City
                        - attributes: null
                          label: County
                          validFor: []
                          value: County
                        - attributes: null
                          label: State
                          validFor: []
                          value: State
                        - attributes: null
                          label: Unknown
                          validFor: []
                          value: Unknown
                      Salutation:
                        controllerValues: {}
                        defaultValue: null
                        eTag: 2de0a04925bdf8e3c70fe1177129a63f
                        url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/Salutation
                        values:
                        - attributes: null
                          label: Mr.
                          validFor: []
                          value: Mr.
                        - attributes: null
                          label: Ms.
                          validFor: []
                          value: Ms.
                        - attributes: null
                          label: Mrs.
                          validFor: []
                          value: Mrs.
                        - attributes: null
                          label: Dr.
                          validFor: []
                          value: Dr.
                        - attributes: null
                          label: Prof.
                          validFor: []
                          value: Prof.
                contentMediaType: application/json;charset=UTF-8
              example:
                eTag: ef21257ca08f8952ff154f57dc775336
                picklistFieldValues:
                  CleanStatus:
                    controllerValues: {}
                    defaultValue: null
                    eTag: bd535d2876948d8bb91fad409b69e359
                    url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/CleanStatus
                    values:
                    - attributes: null
                      label: In Sync
                      validFor: []
                      value: Matched
                    - attributes: null
                      label: Different
                      validFor: []
                      value: Different
                    - attributes: null
                      label: Reviewed
                      validFor: []
                      value: Acknowledged
                    - attributes: null
                      label: Not Found
                      validFor: []
                      value: NotFound
                    - attributes: null
                      label: Inactive
                      validFor: []
                      value: Inactive
                    - attributes: null
                      label: Not Compared
                      validFor: []
                      value: Pending
                    - attributes: null
                      label: Select Match
                      validFor: []
                      value: SelectMatch
                    - attributes: null
                      label: Skipped
                      validFor: []
                      value: Skipped
                  LeadSource:
                    controllerValues: {}
                    defaultValue: null
                    eTag: edb5c49da4ff7bfe2cf15ecae67a306c
                    url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/LeadSource
                    values:
                    - attributes: null
                      label: Web
                      validFor: []
                      value: Web
                    - attributes: null
                      label: Phone Inquiry
                      validFor: []
                      value: Phone Inquiry
                    - attributes: null
                      label: Partner Referral
                      validFor: []
                      value: Partner Referral
                    - attributes: null
                      label: Purchased List
                      validFor: []
                      value: Purchased List
                    - attributes: null
                      label: Other
                      validFor: []
                      value: Other
                  Level__c:
                    controllerValues: {}
                    defaultValue: null
                    eTag: ffef8adfed014c3057fd14658f5202c4
                    url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/Level__c
                    values:
                    - attributes: null
                      label: Secondary
                      validFor: []
                      value: Secondary
                    - attributes: null
                      label: Tertiary
                      validFor: []
                      value: Tertiary
                    - attributes: null
                      label: Primary
                      validFor: []
                      value: Primary
                  MailingGeocodeAccuracy:
                    controllerValues: {}
                    defaultValue: null
                    eTag: 776a2f5e98c411bafb45081e39a6f1ec
                    url: /services/data/v58.0/ui-api/object-info/Contact/picklist-values/012000000000000AAA/MailingGeocodeAccuracy
                    values:
                    - attributes: null
                      label: Address
                      validFor: []
                      value: Address
                    - attributes: null
                      label: NearAddress
                      validFor: []
                      value: NearAddress
                    - attributes: null
                      label: Block
                      validFor: []
                      value: Block
                    - attributes: null
                      label: Street
                      validFor: []
                      value: Street
                    - attributes: null
                      label: ExtendedZip
                      validFor: []
                      value: ExtendedZip
                    - attributes: null
                      label: Zip
                      validFor: []
                      value: Zip
                    - attributes: null
                      label: Neighborhood
                      validFor: []
                      value: Neighborhood
                    - attributes: null
                      label: City
                      validFor: []
                      value: City
                    - attributes: null
                      label: County
                      validFor: []
    

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