{"files":{"SKILL.md":"---\nname: bc-data-catalogue-api\ndescription: \"BC Data Catalogue API skill. Use when working with BC Data Catalogue for action. Covers 22 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# BC Data Catalogue API\nAPI version: 3.0.1\n\n## Auth\nOAuth2 | ApiKey ckan_api_key in header\n\n## Base URL\nhttps://catalogue.data.gov.bc.ca/api/3\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /action/tag_list -- get a list of tags\n3. Explore available endpoints below\n\n## Endpoints\n22 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Action\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /action/tag_list | Get a list of tags |\n| GET | /action/status_show | Get the site status |\n| GET | /action/package_list | Get a list of all packages (datasets) |\n| GET | /action/package_search | Find packages (datasets) matching query terms |\n| GET | /action/package_show | Get metadata about one specific package (dataset) |\n| GET | /action/package_activity_list | Get the activity stream of a package (dataset) |\n| GET | /action/package_activity_list_html | Get the activity stream of a package (dataset), HTML format |\n| GET | /action/package_autocomplete | Find packages (datasets) matching a query |\n| GET | /action/package_relationships_list | Get package (dataset) relationships |\n| GET | /action/package_revision_list | Get list of revisions for a package (dataset) |\n| GET | /action/organization_activity_list | Get the activity stream of an organization |\n| GET | /action/organization_activity_list_html | Get the activity stream of an organization, HTML format |\n| GET | /action/organization_follower_count | Get number of followers of an organization |\n| GET | /action/organization_follower_list | Get users following an organization |\n| GET | /action/organization_list_for_user | Get organizations that a user has a given permission for |\n| GET | /action/organization_revision_list | Get organization revisions |\n| GET | /action/organization_show | Get details of a specific organization |\n| GET | /action/organization_list | Get names of all organizations |\n| GET | /action/organization_autocomplete | Get names of organizations that match a query string |\n| GET | /action/resource_search | Find resources |\n| GET | /action/resource_show | Get metadata for a specific resource |\n| GET | /action/related_list | Gets items related to a package (dataset) |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all tag_list?\" -> GET /action/tag_list\n- \"List all status_show?\" -> GET /action/status_show\n- \"List all package_list?\" -> GET /action/package_list\n- \"Search package_search?\" -> GET /action/package_search\n- \"List all package_show?\" -> GET /action/package_show\n- \"List all package_activity_list?\" -> GET /action/package_activity_list\n- \"List all package_activity_list_html?\" -> GET /action/package_activity_list_html\n- \"Search package_autocomplete?\" -> GET /action/package_autocomplete\n- \"List all package_relationships_list?\" -> GET /action/package_relationships_list\n- \"List all package_revision_list?\" -> GET /action/package_revision_list\n- \"List all organization_activity_list?\" -> GET /action/organization_activity_list\n- \"List all organization_activity_list_html?\" -> GET /action/organization_activity_list_html\n- \"List all organization_follower_count?\" -> GET /action/organization_follower_count\n- \"List all organization_follower_list?\" -> GET /action/organization_follower_list\n- \"List all organization_list_for_user?\" -> GET /action/organization_list_for_user\n- \"List all organization_revision_list?\" -> GET /action/organization_revision_list\n- \"List all organization_show?\" -> GET /action/organization_show\n- \"List all organization_list?\" -> GET /action/organization_list\n- \"Search organization_autocomplete?\" -> GET /action/organization_autocomplete\n- \"Search resource_search?\" -> GET /action/resource_search\n- \"List all resource_show?\" -> GET /action/resource_show\n- \"List all related_list?\" -> GET /action/related_list\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api BC Data Catalogue API\n@base https://catalogue.data.gov.bc.ca/api/3\n@version 3.0.1\n@auth OAuth2 | ApiKey ckan_api_key in header\n@endpoints 22\n@hint download_for_search\n@toc action(22)\n\n@endpoint GET /action/tag_list\n@desc Get a list of tags\n@optional {offset: int=0 # The offset (index) of the first tag to return, limit: int=100 # The number of tags to be returned per page}\n@returns(200) List of tags\n\n@endpoint GET /action/status_show\n@desc Get the site status\n@returns(200) Returns the site status, version, installed extensions\n\n@endpoint GET /action/package_list\n@desc Get a list of all packages (datasets)\n@optional {offset: int=0 # The offset (index) of the first package to return, limit: int=100 # The number of packages to be returned per page}\n@returns(200) List of packages\n\n@endpoint GET /action/package_search\n@desc Find packages (datasets) matching query terms\n@optional {q: str=\"Okanagan Lake\" # A query string}\n@returns(200) List of packages\n\n@endpoint GET /action/package_show\n@desc Get metadata about one specific package (dataset)\n@optional {id: str=grizzly-bear-population-units # The package name}\n@returns(200) A package metadata object\n\n@endpoint GET /action/package_activity_list\n@desc Get the activity stream of a package (dataset)\n@optional {id: str=grizzly-bear-population-units # The id or name of the package, offset: int=0 # Where to start getting activity items from, limit: int=31 # The maximum number of activities to return}\n@returns(200) List of activities\n\n@endpoint GET /action/package_activity_list_html\n@desc Get the activity stream of a package (dataset), HTML format\n@optional {id: str=grizzly-bear-population-units # The id or name of the package, offset: int=0 # Where to start getting activity items from, limit: int=31 # The maximum number of activities to return}\n@returns(200) List of activities rendered as HTML snippet\n\n@endpoint GET /action/package_autocomplete\n@desc Find packages (datasets) matching a query\n@optional {q: str=\"Okanagan Lake\" # The string to query, limit: int=10 # The maximum number of resource formats to return}\n@returns(200) List of datasets that match a string\n\n@endpoint GET /action/package_relationships_list\n@desc Get package (dataset) relationships\n@optional {id: str=grizzly-bear-population-units # The id or name of the first package, id2: str=important-fossil-areas # The id or name of the second package, rel: str # relationship as string}\n@returns(200) List of dataset relationships\n\n@endpoint GET /action/package_revision_list\n@desc Get list of revisions for a package (dataset)\n@optional {id: str=grizzly-bear-population-units # The id or name of the dataset}\n@returns(200) List of dataset revisions\n\n@endpoint GET /action/organization_activity_list\n@desc Get the activity stream of an organization\n@optional {id: str=ministry-of-agriculture # The id or name of the organization}\n@returns(200) List of an organization's activities\n\n@endpoint GET /action/organization_activity_list_html\n@desc Get the activity stream of an organization, HTML format\n@optional {id: str=ministry-of-agriculture # The id or name of the organization}\n@returns(200) List of an organization's activities in HTML\n\n@endpoint GET /action/organization_follower_count\n@desc Get number of followers of an organization\n@optional {id: str=ministry-of-agriculture # The id or name of the organization}\n@returns(200) Count of organization followers\n\n@endpoint GET /action/organization_follower_list\n@desc Get users following an organization\n@optional {id: str=ministry-of-agriculture # The id or name of the organization}\n@returns(200) List of organization followers\n\n@endpoint GET /action/organization_list_for_user\n@desc Get organizations that a user has a given permission for\n@optional {permission: str=\"edit_group\" # The permission the user has against the returned organization}\n@returns(200) List of organizations for given permission\n\n@endpoint GET /action/organization_revision_list\n@desc Get organization revisions\n@optional {id: str=ministry-of-agriculture # The name or id of the organization}\n@returns(200) List of an organization's revisions\n\n@endpoint GET /action/organization_show\n@desc Get details of a specific organization\n@optional {id: str=ministry-of-agriculture # The id or name of the organization, include_datasets: bool=true # include a list of the organization's datasets}\n@returns(200) List organization details\n\n@endpoint GET /action/organization_list\n@desc Get names of all organizations\n@optional {offset: int=0 # The offset (index) of the first organizations to return, limit: int=100 # The number of organizations to be returned per page}\n@returns(200) List of organizations\n\n@endpoint GET /action/organization_autocomplete\n@desc Get names of organizations that match a query string\n@optional {q: str=ministry # The string to search for, limit: int=20 # The maximum number of organizations to return (optional)}\n@returns(200) List of organizations\n\n@endpoint GET /action/resource_search\n@desc Find resources\n@optional {query: str=format:csv # The search criteria string or list of strings of the form ``{field}:{term1}``, fields: str # Depreciated, order_by: str # A field on the resource model that orders the results, offset: int=0 # Apply an offset to the query, limit: int=0 # Apply a limit to the query}\n@returns(200) Search for resources\n\n@endpoint GET /action/resource_show\n@desc Get metadata for a specific resource\n@optional {id: str=e6c8bb1d-3726-418b-9b7e-1d97a9bbb817 # The id of the resource, include_tracking: bool=false # Add tracking information to dataset}\n@returns(200) Return metadata of a resource\n\n@endpoint GET /action/related_list\n@desc Gets items related to a package (dataset)\n@optional {id: str # id or name of the dataset (optional), dataset: str # Dataset dictionary of the dataset (optional), type_filter: str # The type of related item to show (optional), sort: str # The order to sort the related items in, featured: str # whether or not to restrict the results to only featured items}\n@returns(200) Search for related items\n\n@end\n"}}