openapi: 3.2.0
info:
  title: Data.gov Catalog Action API
  description: 'The data.gov catalog is powered by CKAN, a powerful open source data platform that includes a robust API. Please be aware that data.gov and the data.gov CKAN API only contain metadata about datasets. This metadata includes URLs and descriptions of datasets, but it does not include the actual data within each dataset.


    Complete API documentation is available from CKAN.'
  termsOfService: https://www.data.gov/privacy-policy
  contact:
    name: Data.gov Team
    url: https://www.data.gov/
    email: datagov@gsa.gov
  license:
    name: Creative Commons CC0 1.0 Universal
    url: https://creativecommons.org/publicdomain/zero/1.0/legalcode
  version: '20191213'
servers:
- url: https://catalog.data.gov/api/3
  description: Data.gov Catalog
security: []
tags:
- name: Action
  description: CKAN's Action API is a powerful, RPC-style API that exposes all of CKAN's core features to API clients.
  externalDocs:
    description: Find out more
    url: https://docs.ckan.org/en/ckan-2.3.5/api/index.html
paths:
  /action/tag_list:
    get:
      summary: Get a list of tags
      description: Returns the names of all indexed tags
      parameters:
      - name: offset
        in: query
        description: The offset (index) of the first tag to return
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: The number of tags to be returned per page
        schema:
          type: integer
          default: 100
      tags:
      - Action
      responses:
        '200':
          description: List of tags
      operationId: getActionTagList
      x-operation-id-source: derived
  /action/status_show:
    get:
      summary: Get the site status
      description: Returns the site status
      tags:
      - Action
      responses:
        '200':
          description: Returns the site status, version, installed extensions
      operationId: getActionStatusShow
      x-operation-id-source: derived
  /action/package_list:
    get:
      summary: Get a list of all packages (datasets)
      description: Returns the names of all indexed packages (datasets)
      parameters:
      - name: offset
        in: query
        description: The offset (index) of the first package to return
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: The number of packages to be returned per page
        schema:
          type: integer
          default: 100
      tags:
      - Action
      responses:
        '200':
          description: List of packages
      operationId: getActionPackageList
      x-operation-id-source: derived
  /action/package_search:
    get:
      summary: Find packages (datasets) matching query terms
      description: Searches for packages (datasets) matching the specified query terms
      parameters:
      - name: q
        in: query
        description: A query string
        schema:
          type: string
          default: '"Lake Tahoe"'
      tags:
      - Action
      responses:
        '200':
          description: List of packages
      operationId: getActionPackageSearch
      x-operation-id-source: derived
  /action/package_show:
    get:
      summary: Get metadata about one specific package (dataset)
      description: Returns metadata about the package (dataset) corresponding to the specified unique name
      parameters:
      - name: id
        in: query
        description: The package name
        schema:
          type: string
          default: grizzly-bear-population-units
      tags:
      - Action
      responses:
        '200':
          description: A package metadata object
      operationId: getActionPackageShow
      x-operation-id-source: derived
  /action/package_activity_list:
    get:
      summary: Get the activity stream of a package (dataset)
      description: Returns a package's activity stream
      parameters:
      - name: id
        in: query
        description: The id or name of the package
        schema:
          type: string
          default: grizzly-bear-population-units
      - name: offset
        in: query
        description: Where to start getting activity items from
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: The maximum number of activities to return
        schema:
          type: integer
          default: 31
      tags:
      - Action
      responses:
        '200':
          description: List of activities
      operationId: getActionPackageActivityList
      x-operation-id-source: derived
  /action/package_activity_list_html:
    get:
      summary: Get the activity stream of a package (dataset), HTML format
      description: The activity stream is rendered as a snippet of HTML meant to be included in an HTML pag, i.e it doesn't have any header or footer.
      parameters:
      - name: id
        in: query
        description: The id or name of the package
        schema:
          type: string
          default: grizzly-bear-population-units
      - name: offset
        in: query
        description: Where to start getting activity items from
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: The maximum number of activities to return
        schema:
          type: integer
          default: 31
      tags:
      - Action
      responses:
        '200':
          description: List of activities rendered as HTML snippet
      operationId: getActionPackageActivityListHtml
      x-operation-id-source: derived
  /action/package_autocomplete:
    get:
      summary: Find packages (datasets) matching a query
      description: Return a list of datasets that match a string
      parameters:
      - name: q
        in: query
        description: The string to query
        schema:
          type: string
          default: '"Lake Tahoe"'
      - name: limit
        in: query
        description: The maximum number of resource formats to return
        schema:
          type: integer
          default: 10
      tags:
      - Action
      responses:
        '200':
          description: List of datasets that match a string
      operationId: getActionPackageAutocomplete
      x-operation-id-source: derived
  /action/package_relationships_list:
    get:
      summary: Get package (dataset) relationships
      description: Return a dataset's relationships
      parameters:
      - name: id
        in: query
        description: The id or name of the first package
        schema:
          type: string
          default: grizzly-bear-population-units
      - name: id2
        in: query
        description: The id or name of the second package
        schema:
          type: string
          default: important-fossil-areas
      - name: rel
        in: query
        description: relationship as string
        schema:
          type: string
      tags:
      - Action
      responses:
        '200':
          description: List of dataset relationships
      operationId: getActionPackageRelationshipsList
      x-operation-id-source: derived
  /action/package_revision_list:
    get:
      summary: Get list of revisions for a package (dataset)
      description: Return a dataset's revision as a list of dictionaries
      parameters:
      - name: id
        in: query
        description: The id or name of the dataset
        schema:
          type: string
          default: grizzly-bear-population-units
      tags:
      - Action
      responses:
        '200':
          description: List of dataset revisions
      operationId: getActionPackageRevisionList
      x-operation-id-source: derived
  /action/organization_activity_list:
    get:
      summary: Get the activity stream of an organization
      description: Return an organization's activity stream
      parameters:
      - name: id
        in: query
        description: The id or name of the organization
        schema:
          type: string
          default: general-services-administration
      tags:
      - Action
      responses:
        '200':
          description: List of an organization's activities
      operationId: getActionOrganizationActivityList
      x-operation-id-source: derived
  /action/organization_activity_list_html:
    get:
      summary: Get the activity stream of an organization, HTML format
      description: Return an organization's activity stream as HTML
      parameters:
      - name: id
        in: query
        description: The id or name of the organization
        schema:
          type: string
          default: general-services-administration
      tags:
      - Action
      responses:
        '200':
          description: List of an organization's activities in HTML
      operationId: getActionOrganizationActivityListHtml
      x-operation-id-source: derived
  /action/organization_follower_count:
    get:
      summary: Get number of followers of an organization
      description: Return the number of followers of an organization
      parameters:
      - name: id
        in: query
        description: The id or name of the organization
        schema:
          type: string
          default: general-services-administration
      tags:
      - Action
      responses:
        '200':
          description: Count of organization followers
      operationId: getActionOrganizationFollowerCount
      x-operation-id-source: derived
  /action/organization_follower_list:
    get:
      summary: Get users following an organization
      description: Return a list of users that are following a given organization
      parameters:
      - name: id
        in: query
        description: The id or name of the organization
        schema:
          type: string
          default: general-services-administration
      tags:
      - Action
      responses:
        '200':
          description: List of organization followers
      operationId: getActionOrganizationFollowerList
      x-operation-id-source: derived
  /action/organization_list_for_user:
    get:
      summary: Get organizations that a user has a given permission for
      description: Return the organizations that the user has a given permission for
      parameters:
      - name: permission
        in: query
        description: The permission the user has against the returned organization
        schema:
          type: string
          default: '"edit_group"'
      tags:
      - Action
      responses:
        '200':
          description: List of organizations for given permission
      operationId: getActionOrganizationListForUser
      x-operation-id-source: derived
  /action/organization_revision_list:
    get:
      summary: Get organization revisions
      description: Return an organization's revisions
      parameters:
      - name: id
        in: query
        description: The name or id of the organization
        schema:
          type: string
          default: general-services-administration
      tags:
      - Action
      responses:
        '200':
          description: List of an organization's revisions
      operationId: getActionOrganizationRevisionList
      x-operation-id-source: derived
  /action/organization_show:
    get:
      summary: Get details of a specific organization
      description: Return the details of an organization
      parameters:
      - name: id
        in: query
        description: The id or name of the organization
        schema:
          type: string
          default: general-services-administration
      - name: include_datasets
        in: query
        description: include a list of the organization's datasets
        schema:
          type: boolean
          default: true
      tags:
      - Action
      responses:
        '200':
          description: List organization details
      operationId: getActionOrganizationShow
      x-operation-id-source: derived
  /action/organization_list:
    get:
      summary: Get names of all organizations
      description: Returns the names of all indexed organizations
      parameters:
      - name: offset
        in: query
        description: The offset (index) of the first organizations to return
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: The number of organizations to be returned per page
        schema:
          type: integer
          default: 100
      tags:
      - Action
      responses:
        '200':
          description: List of organizations
      operationId: getActionOrganizationList
      x-operation-id-source: derived
  /action/organization_autocomplete:
    get:
      summary: Get names of organizations that match a query string
      description: Return a list of organization names that contain a string
      parameters:
      - name: q
        in: query
        description: The string to search for
        schema:
          type: string
          default: department-
      - name: limit
        in: query
        description: The maximum number of organizations to return (optional)
        schema:
          type: integer
          default: 20
      tags:
      - Action
      responses:
        '200':
          description: List of organizations
      operationId: getActionOrganizationAutocomplete
      x-operation-id-source: derived
  /action/resource_search:
    get:
      summary: Find resources
      description: Returns a dictionary with two fields ``count`` and ``results``. The ``count`` field contains the total number of Resources found without the limit or query parameters having an effect. The ``results`` field is a list of dictized Resource objects. The query parameter is a required field. It is a string in the form ``{field}:{term}`` or a list of strings, each of the same form. Within each string, ``{field}`` is a field or extra field on the Resource domain object.
      parameters:
      - name: query
        in: query
        description: The search criteria string or list of strings of the form ``{field}:{term1}``
        schema:
          type: string
          default: format:csv
      - name: fields
        in: query
        description: Depreciated
        schema:
          type: string
      - name: order_by
        in: query
        description: A field on the resource model that orders the results
        schema:
          type: string
      - name: offset
        in: query
        description: Apply an offset to the query
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: Apply a limit to the query
        schema:
          type: integer
          default: 0
      tags:
      - Action
      responses:
        '200':
          description: Search for resources
      operationId: getActionResourceSearch
      x-operation-id-source: derived
  /action/resource_show:
    get:
      summary: Get metadata for a specific resource
      description: Return the metadata of a resource
      parameters:
      - name: id
        in: query
        description: The id of the resource
        schema:
          type: string
          default: e6c8bb1d-3726-418b-9b7e-1d97a9bbb817
      - name: include_tracking
        in: query
        description: Add tracking information to dataset
        schema:
          type: boolean
          default: false
      tags:
      - Action
      responses:
        '200':
          description: Return metadata of a resource
      operationId: getActionResourceShow
      x-operation-id-source: derived
  /action/related_list:
    get:
      summary: Gets items related to a package (dataset)
      description: Returns a dataset's related items.
      parameters:
      - name: id
        in: query
        description: id or name of the dataset (optional)
        schema:
          type: string
      - name: dataset
        in: query
        description: Dataset dictionary of the dataset (optional)
        schema:
          type: string
      - name: type_filter
        in: query
        description: The type of related item to show (optional)
        schema:
          type: string
      - name: sort
        in: query
        description: The order to sort the related items in
        schema:
          type: string
      - name: featured
        in: query
        description: whether or not to restrict the results to only featured items
        schema:
          type: string
      tags:
      - Action
      responses:
        '200':
          description: Search for related items
      operationId: getActionRelatedList
      x-operation-id-source: derived