University of Wisconsin-Madison

University of Wisconsin-Madison Organization Structures API

The organizationStructures API from University of Wisconsin-Madison — 2 operation(s) for organizationstructures.

Documentation GitHub OpenAPI

Operations 2

GET /people/{id}/organizationStructures Get Organization Structures. #

GET /people/{id}/jobs/{jobId}/organizationStructure Get Job Organization Structure. #

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/university-of-wisconsin-madison-organizationstructures-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: University Of Wisconsin Madison Organization Structures API
  version: 1.0.0
  contact:
    name: DoIT Enterprise Integration API Team
    email: api@doit.wisc.edu
    url: https://go.wisc.edu/k701y6
  description: 'Operations tagged organizationStructures across 2 of this provider''s published API definitions: university-of-wisconsin-madison-mock-person-api-openapi.yml, university-of-wisconsin-madison-person-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://mock.api.wisc.edu
- url: https://api.wisc.edu
security:
- OAuth2ClientCredentials: []
tags:
- name: organizationStructures
paths:
  /people/{id}/organizationStructures:
    get:
      description: 'Get the UW Organization Structures for a person. Refer to this page for more information on UW Organization Structure: [https://secure.atp.wisconsin.edu/uw-organization-structure](https://secure.atp.wisconsin.edu/uw-organization-structure)'
      summary: Get Organization Structures.
      operationId: get_person_organization_structures
      tags:
      - organizationStructures
      parameters:
      - name: id
        description: 'ID of a person. This parameter should not be manually built/concatenated, but instead be used by following the fully-formed links returned in an API response. To get a person by an ID, use query parameters to search by a specific identifier. Example: /people?filter[identifiers.name]=netId&filter[identifiers.value]=bbadger'
        in: path
        example: e2118c5a-aae2-4475-a661-bb0592effefa
        required: true
        schema:
          type: string
          description: An ephemeral identifier used only in the Person API to adhere to the [JSON:API specification](https://jsonapi.org/format/#document-resource-object-identification). This ID may change if a person is split into two people or two people are merged into one person. This ID is used for paginating results or following other links returned in the API response. This ID should not be stored in a consuming system. Concatenating parts of the URL to form a link is discouraged. Instead, use the fully-formed links returned in an API response.
      - name: fields
        in: query
        description: Specify the list of fields you would like to return for each resource type.  For example, `fields[people]=firstName,lastName` will just return the names for people.  If you are including related resources with 'includes' you can also specify fields on those resources as well.  For example, `includes=jobs&fields[people]=jobs&fields[jobs]=title` will just return titles for jobs.  See [Sparse Fieldsets](https://jsonapi.org/format/#fetching-sparse-fieldsets) for more details.
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: false
          properties:
            type:
              type: string
              example: people
      - name: advancedFilter
        in: query
        description: Filter results of query using the [Advanced Filter](https://kb.wisc.edu/uw-apis/158404#advanced-filters).
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: false
          properties:
            attribute:
              type: string
              example: and(equals(firstName, "John"), equals(lastName, "Doe"))
      - name: filter[institutionId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `institutionId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[institutionName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `institutionName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[executiveOfficeId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `executiveOfficeId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[executiveOfficeName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `executiveOfficeName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[subExecutiveOfficeId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `subExecutiveOfficeId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[subExecutiveOfficeName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `subExecutiveOfficeName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[collegeDivisionId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `collegeDivisionId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[collegeDivisionName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `collegeDivisionName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[subDivisionId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `subDivisionId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[subDivisionName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `subDivisionName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[departmentId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `departmentId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[departmentName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `departmentName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[subDepartmentId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `subDepartmentId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[subDepartmentName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `subDepartmentName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[supervisoryOrganizationId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `supervisoryOrganizationId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[supervisoryOrganizationName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `supervisoryOrganizationName`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[costCenterId]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `costCenterId`.
        schema:
          type:
          - string
          - 'null'
      - name: filter[costCenterName]
        in: query
        required: false
        description: Filter results using the [filter query parameter family](https://jsonapi.org/recommendations/#filtering). Refer to the [Person API Documentation](https://kb.wisc.edu/uw-apis/158404) for more information. Filter `organizationStructures` resources by `costCenterName`.
        schema:
          type:
          - string
          - 'null'
      responses:
        '200':
          description: A collection of organizationStructures for a Person.
          content:
            application/vnd.api+json:
              schema:
                type: object
                required:
                - data
                - links
                properties:
                  data:
                    description: A collection of organization structures
                    type: array
                    items:
                      description: Details about an Organization Structure associated with a person or job.
                      type: object
                      required:
                      - type
                      - id
                      - attributes
                      - relationships
                      properties:
                        type:
                          type: string
                          example: organizationStructures
                        id:
                          type: string
                          example: 96896977-87dc-46e3-ad2e-6dddaa99890e
                        attributes:
                          type: object
                          required:
                          - institutionId
                          - institutionName
                          - executiveOfficeId
                          - executiveOfficeName
                          - subExecutiveOfficeId
                          - subExecutiveOfficeName
                          - collegeDivisionId
                          - collegeDivisionName
                          - subDivisionId
                          - subDivisionName
                          - departmentId
                          - departmentName
                          - subDepartmentId
                          - subDepartmentName
                          - supervisoryOrganizationId
                          - supervisoryOrganizationName
                          - costCenterId
                          - costCenterName
                          properties:
                            institutionId:
                              description: The ID of the institution.
                              type:
                              - string
                              - 'null'
                              example: CCH000002
                            institutionName:
                              description: The 13 universities and the Universities of Wisconsin Administration (UWSA).
                              type:
                              - string
                              - 'null'
                              example: UWMSN | CCHL2 | University of Wisconsin Madison Cost Centers
                            executiveOfficeId:
                              description: The ID of the executive office.
                              type:
                              - string
                              - 'null'
                              example: CCH000018
                            executiveOfficeName:
                              description: Units reporting directly to the Chancellor or the top university leadership, such as offices led by a Vice Chancellor, Provost, or Senior Vice President.
                              type:
                              - string
                              - 'null'
                              example: UWMSN | CCHL3 | Provost and Vice Chancellor for Academic Affairs
                            subExecutiveOfficeId:
                              description: The ID of the sub-executive office.
                              type:
                              - string
                              - 'null'
                              example: CCH000029
                            subExecutiveOfficeName:
                              description: Optional level for units reporting to a Vice Chancellor or Provost, often used to distinguish large sub-units.
                              type:
                              - string
                              - 'null'
                              example: UWMSN | CCHL4 | Divisions and Units
                            collegeDivisionId:
                              description: The ID of the college or division.
                              type:
                              - string
                              - 'null'
                              example: CCH000054
                            collegeDivisionName:
                              description: Highest academic or operational units within a division.
                              type:
                              - string
                              - 'null'
                              example: UWMSN | CCHL5 | DoIT | Division of Information Technology
                            subDivisionId:
                              description: The ID of the sub-division.
                              type:
                              - string
                              - 'null'
                              example: CCH000141
                            subDivisionName:
                              description: Optional level for additional grouping.
                              type:
                              - string
                              - 'null'
                              example: UWMSN | CCHL6 | DoIT | Core Services
                            departmentId:
                              description: The ID of the department.
                              type:
                              - string
                              - 'null'
                              example: CCH000447
                            departmentName:
                              description: Academic or administrative departments.
                              type:
                              - string
                              - 'null'
                              example: UWMSN | CCHL7 | DoIT | Application Infrastructure Services
                            subDepartmentId:
                              description: The ID of the sub-department.
                              type:
                              - string
                              - 'null'
                              example: CCH001249
                            subDepartmentName:
                              description: Optional level for further grouping of units below the college or department level.
                              type:
                              - string
                              - 'null'
                              example: UWMSN | CCHL8 | DoIT | Application Infrastructure Services
                            supervisoryOrganizationId:
                              type:
                              - string
                              - 'null'
                              example: SO00001234
                              description: The ID of the supervisory organization.
                            supervisoryOrganizationName:
                              type:
                              - string
                              - 'null'
                              example: AIS Enterprise Integration (EI)
                              description: The name of the supervisory organization.
                            costCenterId:
                              type:
                              - string
                              - 'null'
                              example: CC001234
                              description: The ID of the cost center.
                            costCenterName:
                              type:
                              - string
                              - 'null'
                              example: UWMSN | DOIT | Application Infrastructure Services
                              description: The name of the cost center.
                        relationships:
                          type: object
                          properties:
                            person:
                              description: A generic relationship object
                              type: object
                              properties:
                                links:
                                  type: object
                                  properties:
                                    related:
                                      type: string
                                      example: https://api.wisc.edu/link/to/related/object
                                data:
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    type:
                                      type: string
                                      example: sampleType
                                    id:
                                      type: string
                                      example: sampleId
                            jobs:
                              description: A generic relationship object
                              type: object
                              properties:
                                links:
                                  type: object
                                  properties:
                                    related:
                                      type: string
                                      example: https://api.wisc.edu/link/to/related/object
                                data:
                                  type:
                                  - object
                                  - 'null'
                                  properties:
                                    type:
                                      type: string
                                      example: sampleType
                                    id:
                                      type: string
                                      example: sampleId
                  links:
                    description: The link to access a resource itself
                    type: object
                    properties:
                      self:
                        type: string
                        example: https://api.wisc.edu/link/to/self
              examples:
                example-organization-structures:
                  value:
                    data:
                    - id: 91314182-3a7a-4690-83b2-a0050437c512
                      type: organizationStructures
                      attributes:
                        institutionId: CCH000002
                        institutionName: UWMSN | CCHL2 | University of Wisconsin Madison Cost Centers
                        executiveOfficeId: CCH000018
                        executiveOfficeName: UWMSN | CCHL3 | Provost and Vice Chancellor for Academic Affairs
                        subExecutiveOfficeId: CCH000029
                        subExecutiveOfficeName: UWMSN | CCHL4 | Divisions and Units
                        collegeDivisionId: CCH000054
                        collegeDivisionName: UWMSN | CCHL5 | DoIT | Division of Information Technology
                        subDivisionId: CCH000141
                        subDivisionName: UWMSN | CCHL6 | DoIT | Core Services
                        departmentId: CCH000447
                        departmentName: UWMSN | CCHL7 | DoIT | Application Infrastructure Services
                        subDepartmentId: CCH001249
                        subDepartmentName: UWMSN | CCHL8 | DoIT | Application Infrastructure Services
                        supervisoryOrganizationId: SO00001234
                        supervisoryOrganizationName: AIS Enterprise Integration (EI)
                        costCenterId: CC001234
                        costCenterName: Application Infrastructure Services
                      relationships:
                        jobs:
                          data: null
                        person:
                          data:
                            id: e1ebbf76-7df7-4a43-947e-aa3741693db4
                            type: people
                          links:
                            related: https://api.wisc.edu/people/e1ebbf76-7df7-4a43-947e-aa3741693db4
                    links:
                      self: https://api.wisc.edu/people/e1ebbf76-7df7-4a43-947e-aa3741693db4/organizationStructures
        '400':
          description: A bad request.
          content:
            application/vnd.api+json:
              schema:
                description: A JSON:API error response body containing one or more errors.
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      description: An error
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          example: 0fd247d9-a93c-4b48-bde8-247ce352ebcb
                        status:
                          type: integer
                          example: 400
                        title:
                          type: string
                          example: Error title
                        detail:
                          type: string
                          example: Additional details about the error
                        links:
                          type: object
                        meta:
                          type: object
                        source:
                          type: object
              examples:
                application/vnd.api+json:
                  value:
                    errors:
                    - id: 0fd247d9-a93c-4b48-bde8-247ce352ebcb
                      links: {}
                      meta: {}
                      source: {}
                      status: 400
                      title: Bad Request
                      detail: Invalid properties in query parameters - resource type 'people' has no attribute 'invalid'.
        '401':
          description: Incorrect or expired OAuth token.
          content:
            application/vnd.api+json:
              schema:
                description: A JSON:API error response body containing one or more errors.
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      description: An error
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          example: 0fd247d9-a93c-4b48-bde8-247ce352ebcb
                        status:
                          type: integer
                          example: 400
                        title:
                          type: string
                          example: Error title
                        detail:
                          type: string
                          example: Additional details about the error
                        links:
                          type: object
                        meta:
                          type: object
                        source:
                          type: object
              examples:
                unauthorized-response:
                  value:
                    errors:
                    - status: 401
                      title: Unauthorized
                      detail: Invalid OAuth authentication - InvalidAccessToken
        '403':
          description: The API call is authenticated but the client isn't allowed to perform the requested operation. This can occur when trying to update a resource when granted read-only access.
          content:
            application/vnd.api+json:
              schema:
                description: A JSON:API error response body containing one or more errors.
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      description: An error
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          example: 0fd247d9-a93c-4b48-bde8-247ce352ebcb
                        status:
                          type: integer
                          example: 400
                        title:
                          type: string
                          example: Error title
                        detail:
                          type: string
                          example: Additional details about the error
                        links:
                          type: object
                        meta:
                          type: object
                        source:
                          type: object
              examples:
                name-update-example:
                  value:
                    errors:
                    - status: 403
                      title: Forbidden
                      detail: Client is not allowed to create, update, or delete a person's name.
                no-access-example:
                  value:
                    errors:
                    - status: 403
                      title: Forbidden
                      detail: Requested method is forbidden for endpoint - GET - /people
                disabled-temporarily-example:
                  value:
                    errors:
                    - status: 403
                      title: Forbidden
                      detail: Webhook Create/Update/Delete operations are disabled temporarily. Try again later.
        '404':
          description: Unable to find the specified record
          content:
            application/vnd.api+json:
              schema:
                description: A JSON:API error response body containing one or more errors.
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      description: An error
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          example: 0fd247d9-a93c-4b48-bde8-247ce352ebcb
                        status:
                          type: integer
                          example: 400
                        title:
                          type: string
                          example: Error title
                        detail:
                          type: string
                          example: Additional details about the error
                        links:
                          type: object
                        meta:
                          type: object
                        source:
                          type: object
              examples:
                not-found-example:
                  value:
                    errors:
                    - status: 404
                      title: Not Found
                      detail: Requested resource not found.
        '406':
          description: Servers respond with a 406 Not Acceptable status code if a request’s Accept header contains the JSON:API media type and all instances of that media type are modified with media type parameters.
          content:
            application/vnd.api+json:
              schema:
                description: A JSON:API error response body containing one or more errors.
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      description: An error
                      type: object
                      properties:
                        id:
                          type:
                          - string
                          - 'null'
                          example: 0fd247d9-a93c-4b48-bde8-247ce352ebcb
                        status:
                          type: integer
                          example: 400
                        title:
                          type: string
                          example: Error title
                        detail:
                          type: string
                          example: Additional details about the error
                        links:
                          type: object
                        meta:
                          type: object
                        source:
                          type: object
              examples:
                not-acceptable-example:
                  value:
                    errors:
                    - status: 406
                      title: Not Acceptable
                      detail: Request's Accept header contained the JSON:API media type and all instances of that media type were modified with media type parameters.
       

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/university-of-wisconsin-madison/refs/heads/main/openapi/university-of-wisconsin-madison-organizationstructures-api-openapi.yml

University of Wisconsin-Madison Organization Structures API

Operations 2

Documentation

Specifications

Schemas & Data

Other Resources