{"openapi":"3.0.2","info":{"title":"API Documentation","version":"v1"},"paths":{"\/provider-data\/api\/1\/metastore\/schemas\/dataset\/items\/dgck-syfz":{"get":{"operationId":"dataset-get-item","summary":"Get a single dataset.","tags":["Metastore: dataset"],"parameters":[{"$ref":"#\/components\/parameters\/showReferenceIds"}],"responses":{"200":{"description":"Full dataset item.","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/dataset"}}}},"404":{"$ref":"#\/components\/responses\/404IdNotFound"}}}},"\/provider-data\/api\/1\/datastore\/query\/dgck-syfz\/{index}":{"post":{"operationId":"datastore-datasetindex-query-post","summary":"Query a single datastore resource","tags":["Datastore: query"],"parameters":[{"$ref":"#\/components\/parameters\/datastoreDistributionIndex"}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/datastoreResourceQuery"},"example":{"conditions":[{"resource":"t","property":"record_number","value":1,"operator":"\u003E"}],"limit":3}}}},"responses":{"200":{"$ref":"#\/components\/responses\/200JsonOrCsvQueryOk"},"400":{"$ref":"#\/components\/responses\/400BadJson"},"404":{"$ref":"#\/components\/responses\/404IdNotFound"}}},"get":{"operationId":"datastore-datasetindex-query-get","summary":"Query a single datastore resource with get","description":"Simple GET equivalent of a POST query -- see the POST endpoint documentation for full query schema. A few basic parameters are provided here as examples. For more reliable queries, write your query in JSON and then convert to a query string. See [this web tool](https:\/\/www.convertonline.io\/convert\/json-to-query-string) for an example.","tags":["Datastore: query"],"parameters":[{"$ref":"#\/components\/parameters\/datastoreDistributionIndex"},{"$ref":"#\/components\/parameters\/datastoreQueryLimit"},{"$ref":"#\/components\/parameters\/datastoreQueryOffset"},{"$ref":"#\/components\/parameters\/datastoreQueryCount"},{"$ref":"#\/components\/parameters\/datastoreQueryResults"},{"$ref":"#\/components\/parameters\/datastoreQuerySchema"},{"$ref":"#\/components\/parameters\/datastoreQueryKeys"},{"$ref":"#\/components\/parameters\/datastoreQueryFormat"},{"$ref":"#\/components\/parameters\/datastoreQueryRowIds"}],"responses":{"200":{"$ref":"#\/components\/responses\/200JsonOrCsvQueryOk"},"400":{"$ref":"#\/components\/responses\/400BadJson"},"404":{"$ref":"#\/components\/responses\/404IdNotFound"}}}},"\/provider-data\/api\/1\/datastore\/query\/{distributionId}":{"post":{"operationId":"datastore-resource-query-post","summary":"Query a single datastore resource","tags":["Datastore: query"],"parameters":[{"$ref":"#\/components\/parameters\/datastoreDistributionUuid"}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/datastoreResourceQuery"},"example":{"conditions":[{"resource":"t","property":"record_number","value":1,"operator":"\u003E"}],"limit":3}}}},"responses":{"200":{"$ref":"#\/components\/responses\/200JsonOrCsvQueryOk"},"400":{"$ref":"#\/components\/responses\/400BadJson"},"404":{"$ref":"#\/components\/responses\/404IdNotFound"}}},"get":{"operationId":"datastore-resource-query-get","summary":"Query a single datastore resource with get","description":"Simple GET equivalent of a POST query. Note that parameters containing arrays or objects are not yet supported by SwaggerUI. For conditions, sorts, and other complex parameters, write your query in JSON and then convert to a nested query string. See [this web tool](https:\/\/www.convertonline.io\/convert\/json-to-query-string) for an example.","tags":["Datastore: query"],"parameters":[{"$ref":"#\/components\/parameters\/datastoreDistributionUuid"},{"$ref":"#\/components\/parameters\/datastoreQueryLimit"},{"$ref":"#\/components\/parameters\/datastoreQueryOffset"},{"$ref":"#\/components\/parameters\/datastoreQueryCount"},{"$ref":"#\/components\/parameters\/datastoreQueryResults"},{"$ref":"#\/components\/parameters\/datastoreQuerySchema"},{"$ref":"#\/components\/parameters\/datastoreQueryKeys"},{"$ref":"#\/components\/parameters\/datastoreQueryFormat"},{"$ref":"#\/components\/parameters\/datastoreQueryRowIds"}],"responses":{"200":{"$ref":"#\/components\/responses\/200JsonOrCsvQueryOk"},"400":{"$ref":"#\/components\/responses\/400BadJson"},"404":{"$ref":"#\/components\/responses\/404IdNotFound"}}}},"\/provider-data\/api\/1\/datastore\/sql":{"get":{"operationId":"datastore-sql","summary":"Query resources in datastore","description":"Interact with resources in the datastore using an SQL-like syntax.\n","tags":["Datastore: SQL Query"],"parameters":[{"name":"query","in":"query","description":"A SQL-like query.\n\nA `SELECT` using the `show_db_columns` parameter will make it easier to build queries against the data as\nit returns columns without spaces and in some cases, truncated names where the human readable column header\nis very long.\n\n`\/api\/1\/datastore\/sql?query=[SELECT * FROM DATASTORE_UUID][LIMIT 1 OFFSET 0];\u0026show_db_columns`\n\nYou can then build the `SELECT` part of the query. Do not use spaces between its arguments.\n\n`\/api\/1\/datastore\/sql?query=[SELECT a,b,c, FROM DATASTORE_UUID]`\n\n`WHERE` can use any column in the data.\n\n`\/api\/1\/datastore\/sql?query=[SELECT a,b FROM DATASTORE_UUID][WHERE c = \u0022CCC\u0022];\u0026show_db_columns`\n\n`LIMIT` and `OFFSET` allow you to get more than the 500 record limit, by using successive queries:\n\n`\/api\/1\/datastore\/sql?query=[SELECT a,b,c FROM DATASTORE_UUID][WHERE d = \u0022CCC\u0022][LIMIT 500 OFFSET 0];\u0026show_db_columns`\n\n`\/api\/1\/datastore\/sql?query=[SELECT a,b,c FROM DATASTORE_UUID][WHERE d = \u0022DDD\u0022][LIMIT 500 OFFSET 500];\u0026show_db_columns`\n\nNote: `SELECT`, `WHERE` and `LIMIT...OFFSET` clauses must each be included within brackets `[ ]`.\n","required":true,"schema":{"type":"string"},"style":"form","examples":{"0a2f31d8-59ca-52ec-a6ac-d8689fd33ad5":{"summary":"Query distribution 0a2f31d8-59ca-52ec-a6ac-d8689fd33ad5","value":"[SELECT * FROM 0a2f31d8-59ca-52ec-a6ac-d8689fd33ad5][LIMIT 2]"}}},{"name":"show_db_columns","in":"query","description":"Add `\u0026show_db_columns` to return columns without spaces and in some cases, truncated names where the human\nreadable column header is very long.\n","schema":{"type":"boolean"},"style":"form","allowEmptyValue":true}],"responses":{"200":{"description":"Ok. Query successful.","content":{"application\/json":{"schema":{"type":"array","items":{"type":"object","description":"Simple result row, key\/value pairs."}}}}}}}}},"components":{"parameters":{"datastoreDistributionUuid":{"name":"distributionId","in":"path","description":"A distribution ID","required":true,"schema":{"type":"string"},"examples":{"0a2f31d8-59ca-52ec-a6ac-d8689fd33ad5":{"value":"0a2f31d8-59ca-52ec-a6ac-d8689fd33ad5","summary":"0a2f31d8-59ca-52ec-a6ac-d8689fd33ad5"}}},"datastoreDatasetUuid":{"name":"datasetId","in":"path","description":"A dataset ID","required":true,"schema":{"type":"string"},"example":"dgck-syfz"},"datastoreDistributionIndex":{"name":"index","in":"path","description":"The index of a distribution in a dataset\u0027s distribution array. For instance, the first distribution in a dataset would have an index of \u00220,\u0022 the second would have \u00221\u0022, etc.","required":true,"schema":{"type":"string"},"examples":{"index0":{"value":"0","summary":"0a2f31d8-59ca-52ec-a6ac-d8689fd33ad5"}}},"datastoreQueryLimit":{"name":"limit","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/limit"}},"datastoreQueryOffset":{"name":"offset","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/offset"}},"datastoreQueryCount":{"name":"count","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/count"}},"datastoreQueryResults":{"name":"results","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/results"}},"datastoreQuerySchema":{"name":"schema","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/schema"}},"datastoreQueryKeys":{"name":"keys","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/keys"}},"datastoreQueryFormat":{"name":"format","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/format"}},"datastoreQueryRowIds":{"name":"rowIds","in":"query","style":"deepObject","explode":true,"schema":{"$ref":"#\/components\/schemas\/datastoreQuery\/properties\/rowIds"}},"showReferenceIds":{"name":"show-reference-ids","in":"query","description":"Metastore objects often include references to other objects stored in other schemas. These references are usually hidden in responses. Some identifiers are necessary to work with other API endpoints (e.g. datastore endpoints may require the distribution identifier). Add `?show-reference-ids` to show the identifiers generated by DKAN.","schema":{"type":"boolean","default":false},"style":"form","allowEmptyValue":true},"datasetUuid":{"name":"identifier","in":"path","description":"A dataset identifier","required":true,"schema":{"type":"string"},"example":"dgck-syfz"}},"schemas":{"errorResponse":{"type":"object","properties":{"message":{"type":"string","description":"Error message."},"status":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"},"data":{"type":"object","description":"Arbitrary object storing more detailed data on the error message."}}},"datastoreQuery":{"title":"Datastore Query","description":"Schema for DKAN datastore queries","type":"object","properties":{"resources":{"type":"array","title":"Resources","description":"Resources to query against and aliases. Usually you will add only one resource to this array, but if performing a join, list the primary resource first and then add resources to be used in the joins array.","items":{"type":"object","properties":{"alias":{"type":"string","description":"Alias to use to refer to this resource elsewhere in the query."}}}},"properties":{"type":"array","items":{"anyOf":[{"$ref":"#\/components\/schemas\/datastoreQueryResource"},{"type":"object","title":"Aliased property from specific resource","properties":{"resource":{"$ref":"#\/components\/schemas\/datastoreQueryResource"},"property":{"$ref":"#\/components\/schemas\/datastoreQueryProperty"},"alias":{"type":"string"}},"required":["resource","property"]},{"type":"object","title":"Aliased expression","properties":{"expression":{"$ref":"#\/components\/schemas\/datastoreQueryExpression"},"alias":{"type":"string"}},"required":["expression","alias"]}]}},"conditions":{"type":"array","description":"Conditions or groups of conditions for the query, bound by \u0027and\u0027 operator.","items":{"anyOf":[{"$ref":"#\/components\/schemas\/datastoreQueryCondition"},{"$ref":"#\/components\/schemas\/datastoreQueryConditionGroup"}]}},"joins":{"type":"array","description":"Joins","items":{"type":"object","properties":{"resource":{"$ref":"#\/components\/schemas\/datastoreQueryResource"},"condition":{"$ref":"#\/components\/schemas\/datastoreQueryCondition"}},"required":["resource","condition"]}},"groupings":{"type":"array","description":"Properties or aliases to group results by.","items":{"anyOf":[{"$ref":"#\/components\/schemas\/datastoreQueryResource"},{"$ref":"#\/components\/schemas\/datastoreQueryResourceProperty"}]}},"limit":{"type":"integer","description":"Limit for maximum number of records returned. Must be a minumum of 1.","minimum":1},"offset":{"type":"integer","description":"Number of records to offset by or skip before returning first record.","default":0},"sorts":{"type":"array","description":"Result sorting directives.","items":{"$ref":"#\/components\/schemas\/datastoreQuerySort"}},"count":{"description":"Return a count of the total rows returned by the query, ignoring the limit\/offset.","type":"boolean","default":true},"results":{"description":"Return the result set. Set to false and set count to true to receive only a count of matches.","type":"boolean","default":true},"schema":{"description":"Return the schema for the datastore collection.","type":"boolean","default":true},"keys":{"description":"Return results as an array of keyed objects, with the column machine names as keys. If false, results will be an array of simple arrays of values.","type":"boolean","default":true},"format":{"type":"string","description":"Format to return data in. Default is JSON, can be set to CSV.","enum":["csv","json"],"default":"json"},"rowIds":{"description":"Flag to include the result_number column in output. Default is FALSE","type":"boolean","default":false}}},"datastoreResourceQuery":{"title":"Datastore Resource Query","description":"Schema for DKAN datastore queries. When querying against a specific resource, the \u0022resource\u0022 property is always optional. If you want to set it explicitly, note that it will be aliased to simply \u0022t\u0022.","type":"object","properties":{"properties":{"type":"array","items":{"anyOf":[{"$ref":"#\/components\/schemas\/datastoreQueryResource"},{"type":"object","title":"Aliased property from specific resource","properties":{"resource":{"$ref":"#\/components\/schemas\/datastoreQueryResource"},"property":{"$ref":"#\/components\/schemas\/datastoreQueryProperty"},"alias":{"type":"string"}},"required":["resource","property"]},{"type":"object","title":"Aliased expression","properties":{"expression":{"$ref":"#\/components\/schemas\/datastoreQueryExpression"},"alias":{"type":"string"}},"required":["expression","alias"]}]}},"conditions":{"type":"array","description":"Conditions or groups of conditions for the query, bound by \u0027and\u0027 operator.","items":{"anyOf":[{"$ref":"#\/components\/schemas\/datastoreQueryCondition"},{"$ref":"#\/components\/schemas\/datastoreQueryConditionGroup"}]}},"groupings":{"type":"array","description":"Properties or aliases to group results by.","items":{"anyOf":[{"$ref":"#\/components\/schemas\/datastoreQueryResource"},{"$ref":"#\/components\/schemas\/datastoreQueryResourceProperty"}]}},"limit":{"type":"integer","description":"Limit for maximum number of records returned. Must be a minumum of 1.","minimum":1},"offset":{"type":"integer","description":"Number of records to offset by or skip before returning first record.","default":0},"sorts":{"type":"array","description":"Result sorting directives.","items":{"$ref":"#\/components\/schemas\/datastoreQuerySort"}},"count":{"description":"Return a count of the total rows returned by the query, ignoring the limit\/offset.","type":"boolean","default":true},"results":{"description":"Return the result set. Set to false and set count to true to receive only a count of matches.","type":"boolean","default":true},"schema":{"description":"Return the schema for the datastore collection.","type":"boolean","default":true},"keys":{"description":"Return results as an array of keyed objects, with the column machine names as keys. If false, results will be an array of simple arrays of values.","type":"boolean","default":true},"format":{"type":"string","description":"Format to return data in. Default is JSON, can be set to CSV.","enum":["csv","json"],"default":"json"},"rowIds":{"description":"Flag to include the result_number column in output. Default is FALSE","type":"boolean","default":false}}},"datastoreQueryResource":{"type":"string","description":"Alias to resource set in resources array. Not needed when only querying against one resource.","title":"Datastore Query: resource"},"datastoreQueryProperty":{"type":"string","description":"The property\/column or alias to filter by. Should not include collection\/table alias.","pattern":"^[^.]+$","title":"Datastore Query: property"},"datastoreQueryResourceProperty":{"type":"object","description":"Property name with optional collection\/table alias.","properties":{"resource":{"$ref":"#\/components\/schemas\/datastoreQueryResource"},"property":{"$ref":"#\/components\/schemas\/datastoreQueryProperty"}},"required":["property"],"title":"Datastore Query: resourceProperty"},"datastoreQueryConditionGroup":{"type":"object","title":"Datastore Query: Conditional group","description":"Group of conditions bound by \u0027and\u0027\/\u0027or\u0027 operators.","properties":{"groupOperator":{"type":"string","enum":["and","or"]},"conditions":{"type":"array","items":{"anyOf":[{"$ref":"#\/components\/schemas\/datastoreQueryCondition"},{"$ref":"#\/components\/schemas\/datastoreQueryConditionGroup"}]}}},"required":["conditions"]},"datastoreQueryCondition":{"type":"object","title":"Datastore Query: Condition","description":"Condition object including property, value and operator. If querying only one resource, the \u0022resource\u0022 does not need to be specified.","properties":{"resource":{"$ref":"#\/components\/schemas\/datastoreQueryResource"},"property":{"$ref":"#\/components\/schemas\/datastoreQueryProperty"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},{"$ref":"#\/components\/schemas\/datastoreQueryResourceProperty"}],"description":"The value to filter against."},"operator":{"oneOf":[{"type":"string","description":"Comparison operators","enum":["=","\u003C\u003E","\u003C","\u003C=","\u003E","\u003E=","not_empty","is_empty"]},{"type":"string","pattern":"^([lL][iI][kK][eE]|[bB][eE][tT][wW][eE][eE][nN]|[iI][nN]|[nN][oO][tT] [iI][nN]|[cC][oO][nN][tT][aA][iI][nN][sS]|[sS][tT][aA][rR][tT][sS] [wW][iI][tT][hH]|[mM][aA][tT][cC][hH]|[iI][sS] [eE][mM][pP][tT][yY]|[nN][oO][tT] [eE][mM][pP][tT][yY])$","description":"Alphanumeric comparison operators, case-insensitive. One of: like, between, in, not in, contains, starts with, match, is empty, not empty"}],"default":"="}},"required":["property","value"]},"datastoreQueryExpression":{"type":"object","title":"Datastore Query: Expression","description":"Arithmetic or aggregate expression performed on one or more properties. Note that performing expressions on text or other non-numeric data types my yield unexpected results.","properties":{"operator":{"oneOf":[{"type":"string","pattern":"^([sS][uU][mM]|[cC][oO][uU][nN][tT]|[aA][vV][gG]|[mM][aA][xX]|[mM][iI][nN])$","description":"Aggregate operators, case-insensitive. One of: sum, count, avg, max, min"},{"type":"string","enum":["+","-","*","\/","%"],"description":"Arithmetic operators"}]},"operands":{"type":"array","description":"Arithmetic operators will require two operands, aggregate operators should take only one. Do not combine arithmetic and aggregate operators in a single query.","items":{"anyOf":[{"type":"number","title":"Number"},{"$ref":"#\/components\/schemas\/datastoreQueryProperty"},{"$ref":"#\/components\/schemas\/datastoreQueryResourceProperty"},{"type":"object","title":"Expression","properties":{"expression":{"$ref":"#\/components\/schemas\/datastoreQueryExpression"}}}]}}}},"datastoreQuerySort":{"type":"object","description":"Properties to sort by in a particular order.","properties":{"resource":{"$ref":"#\/components\/schemas\/datastoreQueryResource"},"property":{"$ref":"#\/components\/schemas\/datastoreQueryProperty"},"order":{"type":"string","description":"Order to sort in, lowercase.","enum":["asc","desc"]}},"title":"Datastore Query: sort"},"dataset":{"title":"Project Open Data Dataset","description":"The metadata format for all federal open data. Validates a single JSON object entry (as opposed to entire Data.json catalog).","type":"object","required":["bureauCode","programCode","title","description","keyword","modified","released","publisher","contactPoint","identifier","accessLevel"],"properties":{"@type":{"title":"Metadata Context","type":"string","description":"IRI for the JSON-LD data type. This should be dcat:Dataset for each Dataset.","default":"dcat:Dataset"},"title":{"title":"Title","description":"Human-readable name of the asset. Should be in plain English and include sufficient detail to facilitate search and discovery.","type":"string","minLength":1},"identifier":{"title":"Unique Identifier","description":"A unique identifier for the dataset or API as maintained within an Agency catalog or database.","type":"string","minLength":1},"description":{"title":"Description","description":"Human-readable description (e.g., an abstract) with sufficient detail to enable a user to quickly understand whether the asset is of interest.","type":"string","minLength":1},"accessLevel":{"description":"The degree to which this dataset could be made publicly-available, regardless of whether it has been made available. Choices: public (Data asset is or could be made publicly available to all without restrictions), restricted public (Data asset is available under certain use restrictions), or non-public (Data asset is not available to members of the public).","title":"Public Access Level","type":"string","enum":["public","restricted public","private","non-public"],"default":"public"},"rights":{"title":"Rights","description":"This may include information regarding access or restrictions based on privacy, security, or other policies. This should also provide an explanation for the selected \u0022accessLevel\u0022 including instructions for how to access a restricted file, if applicable, or explanation for why a \u0022non-public\u0022 or \u0022restricted public\u0022 data assetis not \u0022public,\u0022 if applicable. Text, 255 characters.","type":"string","minLength":1,"maxLength":255,"nullable":true},"accrualPeriodicity":{"title":"Frequency","description":"Frequency with which dataset is published.","type":"string","enum":["R\/P10Y","R\/P4Y","R\/P1Y","R\/P2M","R\/P3.5D","R\/P1D","R\/P2W","R\/P6M","R\/P2Y","R\/P3Y","R\/P0.33W","R\/P0.33M","R\/PT1S","R\/P1M","R\/P3M","R\/P0.5M","R\/P4M","R\/P1W","R\/PT1H","irregular"]},"describedBy":{"title":"Data Dictionary","description":"URL to the data dictionary for the dataset or API. Note that documentation other than a data dictionary can be referenced using Related Documents as shown in the expanded fields.","type":"string","format":"uri"},"describedByType":{"title":"Data Dictionary Type","description":"The machine-readable file format (IANA Media Type or MIME Type) of the distribution\u2019s describedBy URL.","type":"string"},"issued":{"title":"Issue Date","description":"Date of formal issuance.","type":"string"},"modified":{"title":"Last Modified","description":"Most recent date on which the dataset was changed, updated or modified.","type":"string"},"released":{"title":"Release Date","description":"Date on which the dataset is scheduled to be published.","type":"string"},"nextUpdateDate":{"title":"Next Update Date","description":"The date on which the dataset is expected to be updated next.","type":"string"},"license":{"title":"License","description":"The license dataset or API is published with. See \u003Ca href=\u0022https:\/\/project-open-data.cio.gov\/open-licenses\/\u0022\u003EOpen Licenses\u003C\/a\u003E for more information.","type":"string","format":"uri"},"spatial":{"title":"Spatial","description":"The \u003Ca href=\u0022https:\/\/project-open-data.cio.gov\/v1.1\/schema\/#spatial\u0022\u003Espatial coverage\u003C\/a\u003E of the dataset. Could include a spatial region like a bounding box or a named place.","type":"string","minLength":1},"temporal":{"title":"Temporal","description":"The \u003Ca href=\u0022https:\/\/project-open-data.cio.gov\/v1.1\/schema\/#temporal\u0022\u003Estart and end dates\u003C\/a\u003E for which the dataset is applicable, separated by a \u0022\/\u0022 (i.e., 2000-01-15T00:45:00Z\/2010-01-15T00:06:00Z).","type":"string"},"isPartOf":{"title":"Collection","description":"The collection of which the dataset is a subset.","type":"string","minLength":1},"publisher":{"title":"Organization","description":"A Dataset Publisher Organization.","type":"object","required":["name"],"properties":{"@type":{"title":"Metadata Context","description":"IRI for the JSON-LD data type. This should be org:Organization for each publisher","type":"string","default":"org:Organization"},"name":{"title":"Publisher Name","description":"","type":"string","minLength":1},"subOrganizationOf":{"title":"Parent Organization","type":"string"}}},"bureauCode":{"title":"Bureau Code","description":"Federal agencies, combined agency and bureau code from \u003Ca href=\u0022http:\/\/www.whitehouse.gov\/sites\/default\/files\/omb\/assets\/a11_current_year\/app_c.pdf\u0022\u003EOMB Circular A-11, Appendix C\u003C\/a\u003E in the format of \u003Ccode\u003E015:010\u003C\/code\u003E.","type":"array","items":{"type":"string","pattern":"[0-9]{3}:[0-9]{2}"},"minItems":1,"uniqueItems":true},"programCode":{"title":"Program Code","description":"Federal agencies, list the primary program related to this data asset, from the \u003Ca href=\u0022http:\/\/goals.performance.gov\/sites\/default\/files\/images\/FederalProgramInventory_FY13_MachineReadable_091613.xls\u0022\u003EFederal Program Inventory\u003C\/a\u003E. Use the format of \u003Ccode\u003E015:001\u003C\/code\u003E","type":"array","items":{"type":"string"},"minItems":1,"uniqueItems":true},"contactPoint":{"title":"Project Open Data ContactPoint vCard","description":"A Dataset ContactPoint as a vCard object.","type":"object","required":["fn"],"oneOf":[{"type":"object","required":["hasEmail"]},{"type":"object","required":["hasURL"]}],"properties":{"@type":{"title":"Metadata Context","description":"IRI for the JSON-LD data type. This should be vcard:Contact for contactPoint.","enum":["vcard:Contact"],"type":"string"},"fn":{"title":"Contact Name","description":"A full formatted name, e.g. Firstname Lastname.","type":"string","minLength":1},"hasEmail":{"title":"Email","description":"Email address for the contact name.","pattern":"^mailto:[\\w\\_\\~\\!\\$\\\u0026\\\u0027\\(\\)\\*\\+\\,\\;\\=\\:.-]+@[\\w.-]+\\.[\\w.-]+?$|[\\w\\_\\~\\!\\$\\\u0026\\\u0027\\(\\)\\*\\+\\,\\;\\=\\:.-]+@[\\w.-]+\\.[\\w.-]+?$","type":"string"},"hasURL":{"title":"URL","description":"URL for the contact","format":"uri","type":"string"}}},"theme":{"title":"Category","description":"Main thematic category of the dataset.","type":"array","items":{"type":"string","title":"Category","minLength":1},"uniqueItems":true},"keyword":{"title":"Tags","description":"Tags (or keywords) help users discover your dataset; please include terms that would be used by technical and non-technical users.","type":"array","items":{"type":"string","title":"Tag","minLength":1},"minItems":1},"distribution":{"title":"Distribution","description":"A distribution is a container for the data object. Each distribution should contain one accessURL or downloadURL. When providing a downloadURL, also include the format of the file.","type":"array","items":{"title":"Data File","type":"object","properties":{"@type":{"title":"Metadata Context","description":"IRI for the JSON-LD data type. This should be dcat:Distribution for each Distribution.","default":"dcat:Distribution","type":"string","readOnly":true},"title":{"title":"Title","description":"Human-readable name of the file.","type":"string","minLength":1},"description":{"title":"Description","description":"Human-readable description of the file.","type":"string","minLength":1},"format":{"title":"Format","description":"A human-readable description of the file format of a distribution (i.e. csv, pdf, kml, etc.).","type":"string"},"mediaType":{"title":"Media Type","description":"The machine-readable file format (\u003Ca href=\u0022https:\/\/www.iana.org\/assignments\/media-types\/media-types.xhtml\u0022\u003EIANA Media Type or MIME Type\u003C\/a\u003E) of the distribution\u2019s downloadURL.","type":"string"},"downloadURL":{"title":"Download URL","description":"URL providing direct access to a downloadable file of a dataset.","type":"string","anyOf":[{"format":"uri"}]},"accessURL":{"title":"Access URL","description":"URL providing indirect access to a dataset.","type":"string","format":"uri"},"conformsTo":{"title":"Data Standard","description":"URI used to identify a standardized specification the distribution conforms to.","type":"string","format":"uri"},"describedBy":{"title":"Data Dictionary","description":"URL to the data dictionary for the distribution found at the downloadURL.","type":"string","format":"uri"},"describedByType":{"title":"Data Dictionary Type","description":"The machine-readable file format (IANA Media Type or MIME Type) of the distribution\u2019s describedBy URL.","pattern":"^[a-z\\\/\\.\\+]+?$","type":"string"}},"minItems":1,"uniqueItems":true}},"references":{"title":"Related Documents","description":"Related documents such as technical information about a dataset, developer documentation, etc.","type":"array","items":{"type":"string","format":"uri"}},"archiveExclude":{"title":"Exclude from Archive","description":"For excluding this dataset from its provider\u0027s \u0027download all datasets\u0027.","type":"boolean"}}}},"responses":{"400BadJson":{"description":"Bad request, usually JSON schema validation failure.","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/errorResponse"},"example":{"message":"JSON Schema validation failed.","status":400,"timestamp":"2021-06-14T13:46:06+00:00","data":{"keyword":"type","pointer":"path\/to\/invalid\/json\/property","message":"The attribute expected to be of type \u0027\u0027object\u0027\u0027 but \u0027array\u0027 given."}}}}},"404IdNotFound":{"description":"Not found, usually due to incorrect identifier.","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/errorResponse"},"example":{"message":"Error retrieving metadata: 00000000-0000-0000-0000-000000000000 not found.","status":404,"timestamp":"2021-06-14T13:46:06+00:00"}}}},"200JsonOrCsvQueryOk":{"description":"Ok. JSON or CSV datastore response, depending on query.","content":{"application\/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"schema":{"type":"object","description":"Schema of all resources queries, keyed by ID."},"query":{"type":"object"}}}},"text\/csv":{"schema":{"type":"string"}}}}}}}