openapi: 3.2.0 info: description: 'This Swagger Page is for the FOIA Request Portal. Information about the FOIA Agency API can be found on the API Specs page. Authorization with API Key Use the Authorize button below to enter your api_key if you have one. You can signup for an API key or use the following api_key for testing. N4aCuDuJO8Ucf1FTR2EzVPZqo8NsSl1c7YLYOk8N Agency Component Entity ID You can use the Entity ID for Office of Information Policy in the examples below: 8216158f-8089-431d-b866-dc334e8d4758' title: National FOIA Portal - JSON CFO Committee API version: Versioning not supported servers: - url: https://api.foia.gov/api security: - APIKeyHeader: [] tags: - name: CFO Committee paths: /node/cfo_committee: get: summary: List CFO Committees description: Endpoint for listing the node--cfo_committee resource type. parameters: - name: page[limit] in: query required: false description: Limiting the result set to 10 reports is necessary due to the high number of Annual Reports.
Learn more about Pagination in the Drupal documentation.
schema: type: number - name: page[offset] in: query required: false description:The offset is the result you want to start with. An offset of 3 and a page[limit] of 10 will list ten items starting from item 3. Each JSON response from the API will have built in pagination under links.
Learn more about Pagination in the Drupal documentation.
schema: type: string - name: sort in: query required: false description:You can sort results in alphabetical order by multiple fields such as title or by author uid.name.
Learn more about sorting in the Drupal documentation.
schema: type: array - name: sort[sort-created][direction] in: query required: false description: You can change the sorting direction by using eitherDESC and ASC.
schema:
type: string
- name: include
in: query
required: false
description: Embed related entities in the JSON response under relationships. Learn more in the documentation.
node_type, revision_uid, uid, menu_link, field_attachments, field_working_groups
schema:
type: string
tags:
- CFO Committee
responses:
'200':
description: successful operation
content:
application/vnd.api+json:
schema:
title: node:cfo_committee Schema
description: Committees of the Chief FOIA Officers Council. Includes title and WYSIWYG description fields.
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/node--cfo_committee/properties/data'
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
'400':
description: Syntax error
'403':
description: 'Forbidden: The api_key is missing'
'404':
description: Not Found
operationId: getNodeCfoCommittee
x-operation-id-source: derived
/node/cfo_committee/{entity}:
get:
summary: View CFO Committee Details
description: 'Endpoint for viewing details for the node--cfo_committee resource type. The individual endpoint contains a resource object with the data for a particular resource or entity.
For Example:
You can use the entity ID e324aa8d-341b-4234-be08-3bf3f19c3af8 to look up details for this CFO Committee.'
parameters:
- name: entity
required: true
in: path
description: The uuid of the node cfo_committee
schema:
type: string
tags:
- CFO Committee
responses:
'200':
description: successful operation
content:
application/vnd.api+json:
schema:
$ref: '#/components/schemas/node--cfo_committee'
'403':
description: 'Forbidden: The api_key is missing'
operationId: getNodeCfoCommitteeByEntity
x-operation-id-source: derived
/node/cfo_committee/{entity}/field_working_groups:
get:
summary: CFO Committee Working Groups
description: Related endpoint for the paragraph--working_groups resource type through the field_working_groups relationship. The related endpoint contains a resource object with the data for a particular related resource or entity.
parameters:
- name: entity
required: true
in: path
description: 'The uuid of the node cfo_committee which you can find by using the List CFO Meetings endpoint above. '
schema:
type: string
tags:
- CFO Committee
responses:
'200':
description: successful operation
content:
application/vnd.api+json:
schema:
title: paragraph:working_groups Schema
description: Describes the payload for 'paragraph' entities of the 'working_groups' bundle.
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/paragraph--working_groups/properties/data'
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
'400':
description: Syntax error
'403':
description: 'Forbidden: The api_key is missing'
'404':
description: Not Found
operationId: getNodeCfoCommitteeByEntityFieldWorkingGroups
x-operation-id-source: derived
/node/cfo_committee/{entity}/field_attachments:
get:
summary: CFO Committee Attachments
description: Endpoint for the paragraph--attachments resource type through the field_attachments relationship.
parameters:
- name: entity
required: true
in: path
description: The uuid of the node cfo_committee
schema:
type: string
tags:
- CFO Committee
responses:
'200':
description: successful operation
content:
application/vnd.api+json:
schema:
title: paragraph:attachments Schema
description: Describes the payload for 'paragraph' entities of the 'attachments' bundle.
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/paragraph--attachments/properties/data'
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
'403':
description: 'Forbidden: The api_key is missing'
operationId: getNodeCfoCommitteeByEntityFieldAttachments
x-operation-id-source: derived
components:
schemas:
paragraph--working_groups:
title: paragraph:working_groups Schema
description: Describes the payload for 'paragraph' entities of the 'working_groups' bundle.
type: object
required:
- data
properties:
data:
description: \"Resource objects\" appear in a JSON:API document to represent resources.
type: object
required:
- type
- id
properties:
type:
type: string
title: type
description: Resource type
enum:
- paragraph--working_groups
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
attributes:
description: Entity attributes
type: object
additionalProperties: false
properties:
drupal_internal__id:
type: integer
title: ID
drupal_internal__revision_id:
type: integer
title: Revision ID
langcode:
type: object
properties:
value:
type: string
title: Language code
language:
type: language_reference
title: Language object
description: The referenced language
required:
- value
title: Language code
description: The paragraphs entity language code.
status:
type: boolean
title: Published
default: true
created:
type: number
title: Authored on
format: utc-millisec
description: The time that the Paragraph was created.
parent_id:
type: string
title: Parent ID
maxLength: 255
description: The ID of the parent entity of which this entity is referenced.
parent_type:
type: string
title: Parent type
maxLength: 32
description: The entity parent type to which this entity is referenced.
parent_field_name:
type: string
title: Parent field name
maxLength: 32
description: The entity parent field name to which this entity is referenced.
behavior_settings:
type: string
title: Behavior settings
description: The behavior plugin settings
default: a:0:{}
default_langcode:
type: boolean
title: Default translation
description: A flag indicating whether this is the default translation.
default: true
revision_default:
type: boolean
title: Default revision
description: A flag indicating whether this was a default revision when it was saved.
revision_translation_affected:
type: boolean
title: Revision translation affected
description: Indicates if the last edit of a translation belongs to current revision.
field_body:
type: object
properties:
value:
type: string
title: Text
format:
type: string
title: Text format
required:
- value
title: Body
field_title:
type: string
title: Title
maxLength: 255
required:
- revision_translation_affected
relationships:
description: Entity relationships
type: object
additionalProperties: false
properties:
paragraph_type:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraphs_type--paragraphs_type
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Paragraph type
field_attachments:
type: object
properties:
data:
type: array
items:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraph--attachments
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Attachments
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
node--cfo_committee:
title: node:cfo_committee Schema
description: Committees of the Chief FOIA Officers Council. Includes title and WYSIWYG description fields.
type: object
required:
- data
properties:
data:
description: \"Resource objects\" appear in a JSON:API document to represent resources.
type: object
required:
- type
- id
properties:
type:
type: string
title: type
description: Resource type
enum:
- node--cfo_committee
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
attributes:
description: Entity attributes
type: object
additionalProperties: false
properties:
drupal_internal__nid:
type: integer
title: ID
drupal_internal__vid:
type: integer
title: Revision ID
langcode:
type: object
properties:
value:
type: string
title: Language code
language:
type: language_reference
title: Language object
description: The referenced language
required:
- value
title: Language
revision_timestamp:
type: number
title: Revision create time
format: utc-millisec
description: The time that the current revision was created.
revision_log:
type: string
title: Revision log message
description: Briefly describe the changes you have made.
default: ''
status:
type: boolean
title: Published
default: true
title:
type: string
title: Title
maxLength: 255
created:
type: number
title: Authored on
format: utc-millisec
description: The time that the node was created.
changed:
type: number
title: Changed
format: utc-millisec
description: The time that the node was last edited.
promote:
type: boolean
title: Promoted to front page
default: false
sticky:
type: boolean
title: Sticky at top of lists
default: false
default_langcode:
type: boolean
title: Default translation
description: A flag indicating whether this is the default translation.
default: true
revision_default:
type: boolean
title: Default revision
description: A flag indicating whether this was a default revision when it was saved.
revision_translation_affected:
type: boolean
title: Revision translation affected
description: Indicates if the last edit of a translation belongs to current revision.
moderation_state:
type: string
title: Moderation state
maxLength: 255
description: The moderation state of this piece of content.
scheduled_transition_date:
type: array
title: Scheduled transition date
items:
type: object
properties:
value:
type: string
title: Date value
format: date
required:
- value
scheduled_transition_state:
type: array
title: Scheduled transition state
items:
type: string
title: Text value
maxLength: 255
scheduled_publication:
type: object
properties:
value:
type: string
title: Date value
format: date
required:
- value
scheduled_moderation_state:
type: string
title: Text value
maxLength: 255
metatag:
type: object
title: Metatags (Hidden field for JSON support)
description: The meta tags for the entity.
path:
type: object
properties:
alias:
type: string
title: Path alias
pid:
type: integer
title: Path id
langcode:
type: string
title: Language Code
title: URL alias
body:
type: object
properties:
value:
type: string
title: Text
format:
type: string
title: Text format
summary:
type: string
title: Summary
required:
- value
title: Body
field_cfo_slug:
type: string
title: URL Slug
maxLength: 100
description: The URL slug is used to make the browser\'s address \"pretty\". Use only lowercase letters and hyphens. A slug is the part of a URL that identifies a particular page on a website in an easy-to-read form.
required:
- title
- revision_translation_affected
- metatag
- path
- field_cfo_slug
relationships:
description: Entity relationships
type: object
additionalProperties: false
properties:
node_type:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- node_type--node_type
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Content type
revision_uid:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- user--user
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Revision user
uid:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- user--user
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Authored by
menu_link:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- menu_link_content--menu_link_content
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Menu link
field_attachments:
type: object
properties:
data:
type: array
items:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraph--attachments
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Attachments
field_working_groups:
type: object
properties:
data:
type: array
items:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraph--working_groups
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Working Groups
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
paragraph--attachments:
title: paragraph:attachments Schema
description: Describes the payload for 'paragraph' entities of the 'attachments' bundle.
type: object
required:
- data
properties:
data:
description: \"Resource objects\" appear in a JSON:API document to represent resources.
type: object
required:
- type
- id
properties:
type:
type: string
title: type
description: Resource type
enum:
- paragraph--attachments
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
attributes:
description: Entity attributes
type: object
additionalProperties: false
properties:
drupal_internal__id:
type: integer
title: ID
drupal_internal__revision_id:
type: integer
title: Revision ID
langcode:
type: object
properties:
value:
type: string
title: Language code
language:
type: language_reference
title: Language object
description: The referenced language
required:
- value
title: Language code
description: The paragraphs entity language code.
status:
type: boolean
title: Published
default: true
created:
type: number
title: Authored on
format: utc-millisec
description: The time that the Paragraph was created.
parent_id:
type: string
title: Parent ID
maxLength: 255
description: The ID of the parent entity of which this entity is referenced.
parent_type:
type: string
title: Parent type
maxLength: 32
description: The entity parent type to which this entity is referenced.
parent_field_name:
type: string
title: Parent field name
maxLength: 32
description: The entity parent field name to which this entity is referenced.
behavior_settings:
type: string
title: Behavior settings
description: The behavior plugin settings
default: a:0:{}
default_langcode:
type: boolean
title: Default translation
description: A flag indicating whether this is the default translation.
default: true
revision_default:
type: boolean
title: Default revision
description: A flag indicating whether this was a default revision when it was saved.
revision_translation_affected:
type: boolean
title: Revision translation affected
description: Indicates if the last edit of a translation belongs to current revision.
field_title:
type: string
title: Title
maxLength: 255
required:
- revision_translation_affected
relationships:
description: Entity relationships
type: object
additionalProperties: false
properties:
paragraph_type:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraphs_type--paragraphs_type
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Paragraph type
field_attachment:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Attachment File
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key