# List an article's authors

**GET /articles/{article}/authors**

Everyone credited on the byline, in the order the creator arranged them.
An article usually has one author, but an imported issue can be
attributed to several team members through the provider's creator field,
and a native issue can be co-signed.

An article whose author was never mapped to a Commune account returns an
empty page rather than a placeholder person.



## Servers
- Production. There is no separate sandbox host.
: https://api.usecommune.com (Production. There is no separate sandbox host.
)


## Authentication methods
- Api key


## Parameters
### Headers

- **Commune-Version** (string(date))
  The contract version this request is written against, as a release date
  (`YYYY-MM-DD`). Omitting the header pins the request to the version that
  was current when the API key was issued, so an integration keeps working
  when a newer version ships. An unknown value answers `400` with
  `invalid_version`.


### Path parameters

- **article** (string)
  The article's `id` (a UUID) or its `short_id`, an eight character base62
  string that is unique across Commune. The `slug` is not accepted here
  because it is unique only within a newsletter.


### Query parameters

- **cursor** (string)
  The `pagination.next_cursor` value from the previous page. Omit it to
  read the first page. A cursor is opaque, is only valid for the same
  operation with the same filters, and is not a durable identifier.

- **limit** (integer)
  How many items to return in this page. This is a page size, not an
  offset. Fewer items than requested may come back and that does not mean
  the collection is exhausted, only an absent `next_cursor` does.

- **fields** (string)
  Comma separated allow list of top level properties to return on each
  object, so a client can trim a response it does not need in full. `id`
  and `object` are always returned. An unknown property name answers
  `400`. Properties omitted by an operation, such as `content` on any
  article list, cannot be brought back with `fields`.

  A trimmed body is a subset of the schema this operation declares, and a
  property that schema marks required is absent when it was not asked for.
  That is the point of the parameter, so a client that validates responses
  against the schema either sends no `fields` or relaxes `required`.



## Responses
### 200
A page of authors, in byline order.

#### Body: application/json (object)
- **object** (string)
  Always `list`, so a response is self describing.

- **data** (array)
  This page of items, in the order the operation documents.

- **pagination** (object)
  Cursor pagination state. Commune never exposes an offset or a page
  number: a collection is a moving window, and an offset silently skips or
  repeats items when the window shifts between two requests.


### 400
The request was malformed: an unknown query parameter, an unparseable
cursor, an unknown `expand` path, or an unrecognised `Commune-Version`.


#### Body: application/json (object)
- **error** (object)


### 401
No API key was presented, or the key is unknown, revoked or expired.

All four answer identically, down to the wording. Saying that a key was
revoked rather than never issued confirms to whoever is holding the
string that it was once real, which a legitimate caller does not need
and a thief should not get.

#### Headers

- **WWW-Authenticate** (string)
  The authentication scheme this API accepts. Always
  `Bearer realm="Commune API"`; there is no second scheme and no
  query-parameter fallback, because a credential that can travel in a
  URL ends up in access logs and referer headers.


#### Body: application/json (object)
- **error** (object)


### 404
No such resource, or the key is not allowed to know that it exists.
Commune answers `404` rather than `403` where distinguishing the two
would leak the existence of private content.


#### Body: application/json (object)
- **error** (object)


### 429
Too many requests. Back off and retry after the interval named by the
`Retry-After` response header.

#### Headers

- **Retry-After** (integer)
  Seconds to wait before retrying.


#### Body: application/json (object)
- **error** (object)


### 500
Something failed inside Commune. The request may be retried.

#### Body: application/json (object)
- **error** (object)



[Powered by Bump.sh](https://bump.sh)