Interfolio Vitas API

Retrieve details of users' vitaes.

Business capability
Educator Workforce Management BC-4760

Operations 3

GET /api.php/vitas Retrieves details of all vitae #
GET /api.php/vitas/{vitaid}/{userid} Retrieves details for a user's vita #
GET /{tenant_id}/vita_templates Paginated set of vitas #

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/interfolio:interfolio-vitas-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 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.

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

OpenAPI Specification

interfolio-vitas-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Interfolio Vitas API
  version: 1.0.0
  x-logo:
    url: /images/logo_faculty180_intf.png
  description: 'Operations tagged Vitas across 2 of this provider''s published API definitions: faculty180-swagger.json, interfolio-faculty180-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://faculty180.interfolio.com
tags:
- name: Vitas
  description: Retrieve details of users' vitaes.
paths:
  /api.php/vitas:
    get:
      tags:
      - Vitas
      summary: Retrieves details of all vitae
      description: 'Description


        Retrieves details on vitas. A count of the vitas will be returned if no parameters are specified.


        Example URL(s)


        https://faculty180.interfolio.com/api.php/vitas?data=detailed'
      operationId: vitas
      parameters:
      - name: unitid
        in: query
        description: "Retrieve a vitae with a specific unitid.\n  *  When defined, filter vitas to the specified unit.\n  *  When undefined, filters vitas from the highest unit accessible."
        schema:
          type: integer
      - name: data
        in: query
        description: "Determines the extent of data that will be returned.\n  *  **Count:** Returns the number of vitas found.\n  *  **Summary:** Returns an array of values for the specified vitas.\n  *  **Detailed:** Returns an array of values for the specified vitas, as well as enabled sections on the vita."
        schema:
          type: string
          enum:
          - count
          - summary
          - detailed
          default: count
      - $ref: '#/components/parameters/q'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/offset'
      responses:
        '200':
          description: A list of Vitaes.
          content:
            application/json:
              example:
              - vitaid: 100
                name: Standard Vita
                form_name: StandardCV
                unit_id: 1
                unit_name: University
                sections:
                - sectionid: -1
                  section_name: Activity Distribution
                - sectionid: 0
                  section_name: string
        default:
          description: an "unexpected" error
    servers:
    - url: https://faculty180.interfolio.com
  /api.php/vitas/{vitaid}/{userid}:
    get:
      tags:
      - Vitas
      summary: Retrieves details for a user's vita
      description: 'Description


        Retrieves details on vitas. A count of the vitas will be returned if no parameters are specified.


        Example URL(s)


        https://faculty180.interfolio.com/api.php/vitas/100/m123456?output=html&termstart=2015/02&termfinish=2017/02'
      operationId: userVita
      parameters:
      - name: vitaid
        in: path
        description: Retrieves details for the specified vitae.
        required: true
        schema:
          type: integer
      - name: userid
        in: path
        description: Retrieves details on the specified user(s).
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/termstart'
      - $ref: '#/components/parameters/termfinish'
      - name: showHidden
        in: query
        description: "Tells the API whether it should respect the 'Publicly Displayed' activity classification in the activity data set that is output.\n\nAllowed values are: \n  *  1 - (default) The 'Publicly Displayed' activity classification is ignored and those activities that a faculty member requested hidden ARE shown, or \n  *  0 -  The 'Publicly Displayed' activity classification is honored and those activities that a faculty member requested hidden ARE NOT shown"
        schema:
          type: integer
      - name: output
        in: query
        description: "A list of Vitaes.\n  *  if output=json\n     * Returns an array of values for the specified vitas, as well as enabled sections on the vita.\n  *  if output=html\n     * Directly displays vita requested as an HTML document with Styling as it would display directly from the software.\n  *  if output=html_clean\n     * Directly displays vita requested as an HTML document with:\n     * All inline styling from DATA180 default styling is removed.\n     * All styling from a user as supplied from rich text edited text is removed (this will be corrected in a later release to try to honor this styling).\n     * Styling applied to each scholarly work for formatting each scholarly citation with the appropriate citation style is retained."
        schema:
          type: string
          enum:
          - html
          - html_clean
          - json
          default: json
      - $ref: '#/components/parameters/q'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/offset'
      responses:
        '200':
          description: A list of Vitaes.
          content:
            application/json:
              example:
              - vitaid: 100
                name: Standard Vita
                form_name: StandardCV
                unit_id: 1
                unit_name: University
                sections:
                - section_name: Memberships
                  activities:
                    activityid: 25
                    fields:
                      Faculty ID: m123456
                      Year Started: 2004
                      Year Ended: 2005
                      Organization Name: International Business Accountants Association
                - section_name: string
                  activities:
                    activityid: 0
                    fields:
                      extrafields: fields
        default:
          description: an "unexpected" error
    servers:
    - url: https://faculty180.interfolio.com
  /{tenant_id}/vita_templates:
    get:
      tags:
      - Vitas
      summary: Paginated set of vitas
      description: Displays a list of vitas that the user can select. Additionally, administrative users have access to vitas at or below their administrative unit.
      operationId: getByTenantIdVitaTemplates
      parameters:
      - name: tenant_id
        in: path
        description: Tenant associated with the request.
        required: true
        schema:
          type: integer
      - $ref: '#/components/parameters/search_text'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/sort_by'
      - $ref: '#/components/parameters/descending'
      - $ref: '#/components/parameters/pid'
      responses:
        '200':
          description: Paginated result set of vitas.
          content:
            application/json:
              example:
              - limit: 15
                page: 1
                total_count: 23
                results:
                - id: 123
                  name: StandardCV
                  label: Standard Vita
                  unit_name: University
        '401':
          description: Not Authenticated
      x-operation-id-source: normalized
      x-operation-id-original: userVita
    servers:
    - url: https://faculty180.interfolio.com
components:
  parameters:
    search_text:
      name: search_text
      in: query
      description: Search term.
      schema:
        type: string
    pid:
      name: pid
      in: query
      description: User pid filter for the given request.
      schema:
        type: integer
    termstart:
      name: termstart
      in: query
      description: 'Value should match the termid of terms.

        *  When defined, limits classification data to the specified starting term.

        *  When undefined, defaults to the current term.'
      schema:
        type: string
    sort_by:
      name: sort_by
      in: query
      description: Sort the results by a desired column.
      schema:
        type: string
    descending:
      name: descending
      in: query
      description: When true, the sort column is sorted in descending order.
      schema:
        type: boolean
    q:
      name: q
      in: query
      description: Search term. Use '*' as wildcard.
      schema:
        type: string
    limit:
      name: limit
      in: query
      description: Limit query to specified number of records.
      schema:
        type: integer
    page:
      name: page
      in: query
      description: Limit query to specified page of records.
      schema:
        type: integer
    offset:
      name: offset
      in: query
      description: Used to offset queries that are segmented into chunks with limit.
      schema:
        type: integer
    termfinish:
      name: termfinish
      in: query
      description: 'Value should match the termid of terms.

        *  When defined, limits classification data to the specified ending term.

        *  When undefined, defaults to the current term.'
      schema:
        type: string
x-refined-from:
- faculty180-swagger.json
- interfolio-faculty180-openapi.yml