{"id":37651673,"url":"https://github.com/stac-extensions/contacts","last_synced_at":"2026-01-16T11:34:33.679Z","repository":{"id":154996902,"uuid":"631943787","full_name":"stac-extensions/contacts","owner":"stac-extensions","description":"A list of contacts with detailed information such as address, phone numbers, emails etc.","archived":false,"fork":false,"pushed_at":"2025-08-15T09:05:30.000Z","size":44,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-08-15T11:15:59.933Z","etag":null,"topics":["contacts","providers","stac"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stac-extensions.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-04-24T11:45:23.000Z","updated_at":"2025-08-15T09:05:04.000Z","dependencies_parsed_at":"2023-06-09T05:30:27.999Z","dependency_job_id":"750aae92-712e-4f4f-8aca-b5587f94180d","html_url":"https://github.com/stac-extensions/contacts","commit_stats":{"total_commits":10,"total_committers":2,"mean_commits":5.0,"dds":0.09999999999999998,"last_synced_commit":"fb288f32a9d0807c0be65af479733935ac31c4ae"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":"stac-extensions/template","purl":"pkg:github/stac-extensions/contacts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stac-extensions%2Fcontacts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stac-extensions%2Fcontacts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stac-extensions%2Fcontacts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stac-extensions%2Fcontacts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stac-extensions","download_url":"https://codeload.github.com/stac-extensions/contacts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stac-extensions%2Fcontacts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478349,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contacts","providers","stac"],"created_at":"2026-01-16T11:34:33.614Z","updated_at":"2026-01-16T11:34:33.668Z","avatar_url":"https://github.com/stac-extensions.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Contacts Extension Specification\n\n- **Title:** Contacts\n- **Identifier:** \u003chttps://stac-extensions.github.io/contacts/v1.0.0/schema.json\u003e\n- **Field Name Prefix:** -\n- **Scope:** Item, Catalog, Collection\n- **Extension [Maturity Classification](https://github.com/radiantearth/stac-spec/tree/master/extensions/README.md#extension-maturity):** Proposal\n- **Owner**: @m-mohr\n\nThis document explains the Contacts Extension to the [SpatioTemporal Asset Catalog](https://github.com/radiantearth/stac-spec) (STAC) specification.\nIt allows to add extensive information about persons and organizations related to the (meta)data.\nThe extension is based on [OGC API - Records](https://ogcapi.ogc.org/records/),\nwhich itself is inspired by [ISO 19115](https://www.iso.org/standard/53798.html).\n\n- Examples:\n  - [Collection example](examples/collection.json): Shows the basic usage of the extension in a STAC Collection\n- [JSON Schema](json-schema/schema.json)\n- [Changelog](./CHANGELOG.md)\n\n## Fields\n\nThe fields in the table below can be used in these parts of STAC documents:\n\n- [x] Catalogs\n- [x] Collections\n- [x] Item Properties (incl. Summaries in Collections)\n- [ ] Assets (for both Collections and Items, incl. Item Asset Definitions in Collections)\n- [ ] Links\n\n| Field Name | Type                                 | Description |\n| ---------- | ------------------------------------ | ----------- |\n| contacts   | \\[[Contact Object](#contact-object)] | **REQUIRED.** A list of contacts qualified by their role. |\n\n### Contact Object\n\nThe Contact Object aimed at the identification of, and means of communication with, a person responsible for the resource.\nEither the field `name` or the field `organization` must be provided (or both).\n\n| Field Name          | Type                                 | Description |\n| ------------------- | ------------------------------------ | ----------- |\n| name                | string                               | **REQUIRED if `organization` is missing**. The name of the responsible person. |\n| organization        | string                               | **REQUIRED if `name` is missing**.Organization/affiliation of the contact. |\n| identifier          | string                               | A value uniquely identifying a contact. |\n| position            | string                               | The name of the role or position of the responsible person taken from the organization's formal organizational hierarchy or chart. |\n| description         | string                               | Detailed multi-line description to fully explain the STAC entity. [CommonMark 0.29](https://commonmark.org/) syntax MAY be used for rich text representation. |\n| logo                | [Link Object](#link-object)          | Graphic identifying a contact. The link relation must be `icon` and the media type must be an image media type. |\n| phones              | \\[[Info Object](#info-object)]       | Telephone numbers at which contact can be made. |\n| emails              | \\[[Info Object](#info-object)]       | Email address at which contact can be made. |\n| addresses           | \\[[Address Object](#address-object)] | Physical location at which contact can be made. |\n| links               | \\[[Link Object](#link-object)\\]      | Links related to the contact. The link relation should be `about` and the media type must indicate the content type of the link (e.g. `text/html` for a company's web page versus `text/vcard` for a virtual contact file). |\n| contactInstructions | string                               | Supplemental instructions on how or when to contact the responsible party. |\n| roles               | \\[string]                            | The set of named duties, job functions and/or permissions associated with this contact. See the [Provider Object](https://github.com/radiantearth/stac-spec/blob/master/item-spec/common-metadata.md#provider-object) for examples. |\n\nOGC API - Records also defines an additional property `hoursOfService` which is omitted from this extension\nfor simplicity. If you need to add the hours of service to your contact object, it is recommended to follow\n[the schema that OGC API - Records defines](https://github.com/opengeospatial/ogcapi-records/blob/master/core/openapi/schemas/contact.yaml).\n\n### Info Object\n\nGives contact information for and their \"roles\".\n\nCurrently, this object can be used in two place:\n\n1. Phone numbers\n   - Pattern for the value: `^+[1-9]{1}[0-9]{3,14}$`.\n   - Potential roles could be `home`, `work`, `fax`, etc.\n2. Email addresses\n   - Must be a valid email address according to\n     [RFC 5321, section 4.1.2](https://datatracker.ietf.org/doc/html/rfc5321#section-4.1.2).\n   - Potential roles could be `home`, `work`, etc.\n\n| Field Name | Type      | Description |\n| ---------- | --------- | ----------- |\n| value      | string    | **REQUIRED**. The actual contact information, depending on the context for example the actual phone number or the email address. |\n| roles      | \\[string] | The type(s) of this contact information, e.g. whether it's at work or at home. |\n\n### Address Object\n\nPhysical location at which contact can be made.\n\n| Field Name         | Type      | Description |\n| ------------------ | --------- | ----------- |\n| deliveryPoint      | \\[string] | Address lines for the location, for example a street name and a house number. |\n| city               | string    | City for the location. |\n| administrativeArea | string    | State or province of the location. |\n| postalCode         | string    | ZIP or other postal code. |\n| country            | string    | Country of the physical address. Could be a free-form country name or an [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements). |\n\n### Link Object\n\nThis object describes a relationship with another entity.\n\n| Field Name | Type   | Description |\n| ---------- | ------ | ----------- |\n| href       | string | **REQUIRED.** The actual link in the format of an URL. Relative and absolute links are both allowed. |\n| rel        | string | **REQUIRED.** Relationship between the current document and the linked document. |\n| type       | string | Media type of the referenced entity. |\n| title      | string | A human readable title to be used in rendered displays of the link. |\n\n## Contributing\n\nAll contributions are subject to the\n[STAC Specification Code of Conduct](https://github.com/radiantearth/stac-spec/blob/master/CODE_OF_CONDUCT.md).\nFor contributions, please follow the\n[STAC specification contributing guide](https://github.com/radiantearth/stac-spec/blob/master/CONTRIBUTING.md) Instructions\nfor running tests are copied here for convenience.\n\n### Running tests\n\nThe same checks that run as checks on PR's are part of the repository and can be run locally to verify that changes are valid. \nTo run tests locally, you'll need `npm`, which is a standard part of any [node.js installation](https://nodejs.org/en/download/).\n\nFirst you'll need to install everything with npm once. Just navigate to the root of this repository and on \nyour command line run:\n```bash\nnpm install\n```\n\nThen to check markdown formatting and test the examples against the JSON schema, you can run:\n```bash\nnpm test\n```\n\nThis will spit out the same texts that you see online, and you can then go and fix your markdown or examples.\n\nIf the tests reveal formatting problems with the examples, you can fix them with:\n```bash\nnpm run format-examples\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstac-extensions%2Fcontacts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstac-extensions%2Fcontacts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstac-extensions%2Fcontacts/lists"}