SEC EDGAR: addressable objects

Addressable object kinds

The identity of an object is sec_edgar:<kind>:<canonical native identifier>. It is the provider’s own identifier inside the provider’s own namespace. It is never derived from a title, a hostname, an address, or a string match, and it is not a Counterpedia identity.

• SEC EDGAR filing

  Native identifier

  Accession number

  Accepted form

  ten digits, a hyphen, two digits, a hyphen, six digits, as NNNNNNNNNN-YY-NNNNNN

  Canonical spelling

  None. The hyphenated form is the only accepted spelling.

  Route

  /providers/sec_edgar/objects/filing/<canonical native identifier>

  • The first ten digits of an accession number are the CIK of the entity that submitted the filing, which can be a filing agent rather than the company the filing concerns. The accession number identifies the filing; it is not a filer identifier.
  • A filing's archive location also needs a filer CIK that an accession number alone does not carry, so no address is derived from this identity.
  Identifier shape taken from provider documentation:

  • https://www.sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data

• SEC EDGAR filer

  Native identifier

  CIK (Central Index Key)

  Accepted form

  one to ten digits, not all zero

  Canonical spelling

  Padded with leading zeros to ten digits. Nothing else is changed.

  Route

  /providers/sec_edgar/objects/filer/<canonical native identifier>

  • A CIK identifies an EDGAR filer account. Company names are never matched to CIKs by this scheme.
  Identifier shape taken from provider documentation:

  • https://www.sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data

Implemented by Counterpedia’s adapter

Two separate lists from two separate artifacts. What a service offers is not what an adapter implements, and neither list is derived from the other.

What the service offers (provider capabilities)

• Search
• Native-ID resolution
• Metadata lookup
• Primary locator

From the pinned inventory. It describes the service, not any adapter.

What the landed adapter declares (implemented capabilities)

• Search
• Native-ID resolution

Landed adapter, manifest pinned

• Offered by the service, not declared by the adapter: Metadata lookup, Primary locator.

Adapter manifest (canonical sha256)

sha256:11f7895d1824c90c825cef60c7d15fae4e55b5e7988ddfe0e6d55895bb9bd1a3

The capability set the landed adapter itself declares, taken from its manifest as pinned at the same snapshot as the inventory. It states what the adapter declares, not that any call has run, succeeded, or returned anything.

Six distinct object families

These are different kinds of thing with different owners. None is an alias of, or a step toward, another; moving from one to the next is a separate act with its own record.

1. Provider — owned by the pinned provider inventory.
   An external service that can help discover sources. Not: A source, and not any object the service holds.
2. Provider object — owned by the provider (its own native identifier).
   One object in a provider's own system, named by the provider's native identifier within that provider's namespace. Not: A Source Record. It carries no Counterpedia source identity and is not evidence, support, or admitted.
3. Discovery observation — owned by Source Intelligence (a sealed record of one provider call).
   What a provider reported at a stated time for one query. Not: A finding that the reported thing exists or is as described, and not a capture.
4. Candidate locator — owned by Source Intelligence (descends from a discovery observation).
   An address a discovery observation turned up as a candidate. Not: Source identity, and not a reason to fetch, trust, or admit what it points at.
5. Captured artifact — owned by Acquisition (exact bytes, with a digest).
   Bytes that were actually retained from one locator at one time. Not: Admitted, supported, authentic, or current by being retained.
6. Source Record — owned by the Counterpedia Source Registry (governed).
   A governed Counterpedia record with its own source identity, capture posture, and admission. Not: Created by addressing, resolving, or listing anything here.