Characters
GET {{baseUrl}}/characters?ts={{ts}}&hash={{hash}}&nameStartsWith=S
Fetches list of comic characters.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
ts | string | Timestamp | |
hash | string | MD5 hash | |
name | null | Return only characters matching the specified full character name (e.g. Spider-Man). | |
nameStartsWith | string | Return characters with names that begin with the specified string (e.g. Sp). | |
modifiedSince | null | Return only characters which have been modified since the specified date. | |
comics | null | Return only characters which appear in the specified comics (accepts a comma-separated list of ids). | |
series | null | Return only characters which appear the specified series (accepts a comma-separated list of ids). | |
events | null | Return only characters which appear in the specified events (accepts a comma-separated list of ids). | |
stories | null | Return only characters which appear the specified stories (accepts a comma-separated list of ids). | |
orderBy | string | Order the result set by a field or fields. |
Add a "-" to the value sort in descending order.
Multiple values are given priority in the order in which they are passed.
You can use the following parameter queries:
name
modified
-name (for descending order)
-modified (for descending order) |
| limit | number | | Limit the result set to the specified number of resources. |
| offset | null | | Skip the specified number of resources in the result set. |
RESPONSES
status: OK
{"code":200,"status":"Ok","copyright":"© 2022 MARVEL","attributionText":"Data provided by Marvel. © 2022 MARVEL","attributionHTML":"\u003ca href=\"http://marvel.com\"\u003eData provided by Marvel. © 2022 MARVEL\u003c/a\u003e","etag":"bad7d513a7d201c4070b82cf67949489e71de09f","data":{"offset":0,"limit":1,"total":84,"count":1,"results":[{"id":1010699,"name":"Aaron Stack","description":"","modified":"1969-12-31T19:00:00-0500","thumbnail":{"path":"http://i.annihil.us/u/prod/marvel/i/mg/b/40/image_not_available","extension":"jpg"},"resourceURI":"http://gateway.marvel.com/v1/public/characters/1010699","comics":{"available":14,"collectionURI":"http://gateway.marvel.com/v1/public/characters/1010699/comics","items":[{"resourceURI":"http://gateway.marvel.com/v1/public/comics/40776","name":"Dark Avengers (2012) #177"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/40773","name":"Dark Avengers (2012) #179"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/40774","name":"Dark Avengers (2012) #180"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/40778","name":"Dark Avengers (2012) #181"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/40787","name":"Dark Avengers (2012) #182"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/40786","name":"Dark Avengers (2012) #183"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/38073","name":"Hulk (2008) #43"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/11910","name":"Universe X (2000) #6"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/11911","name":"Universe X (2000) #7"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/11912","name":"Universe X (2000) #8"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/11913","name":"Universe X (2000) #9"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/11903","name":"Universe X (2000) #10"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/11904","name":"Universe X (2000) #11"},{"resourceURI":"http://gateway.marvel.com/v1/public/comics/11905","name":"Universe X (2000) #12"}],"returned":14},"series":{"available":3,"collectionURI":"http://gateway.marvel.com/v1/public/characters/1010699/series","items":[{"resourceURI":"http://gateway.marvel.com/v1/public/series/789","name":"Dark Avengers (2012 - 2013)"},{"resourceURI":"http://gateway.marvel.com/v1/public/series/3374","name":"Hulk (2008 - 2012)"},{"resourceURI":"http://gateway.marvel.com/v1/public/series/2085","name":"Universe X (2000 - 2001)"}],"returned":3},"stories":{"available":27,"collectionURI":"http://gateway.marvel.com/v1/public/characters/1010699/stories","items":[{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25634","name":"Universe X (2000) #10","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25635","name":"Interior #25635","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25637","name":"Universe X (2000) #12","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25638","name":"Interior #25638","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25647","name":"Universe X (2000) #6","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25648","name":"Interior #25648","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25649","name":"Universe X (2000) #7","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25650","name":"Interior #25650","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25651","name":"Universe X (2000) #8","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25652","name":"Interior #25652","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25653","name":"Universe X (2000) #9","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/25654","name":"Interior #25654","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/67100","name":"Universe X (2000) #11","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/89190","name":"Hulk (2008) #43","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/90002","name":"Interior #90002","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/92370","name":"Dark Avengers (2012) #179","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/92371","name":"Interior #92371","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/92372","name":"Dark Avengers (2012) #180","type":"cover"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/92373","name":"Interior #92373","type":"interiorStory"},{"resourceURI":"http://gateway.marvel.com/v1/public/stories/92376","name":"Dark Avengers (2012) #177","type":"cover"}],"returned":20},"events":{"available":0,"collectionURI":"http://gateway.marvel.com/v1/public/characters/1010699/events","items":[],"returned":0},"urls":[{"type":"detail","url":"http://marvel.com/characters/2809/aaron_stack?utm_campaign=apiRef\u0026utm_source=cc1952a474bd6ba08844d7255330d469"},{"type":"comiclink","url":"http://marvel.com/comics/characters/1010699/aaron_stack?utm_campaign=apiRef\u0026utm_source=cc1952a474bd6ba08844d7255330d469"}]}]}}