The following Challenge Hound endpoints are available with an API key. To request an API key, please contact Challenge Hound support.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"22349866","collectionId":"09646449-066b-41cb-8208-fd1c43c93a3f","publishedId":"UzXLzJUV","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-07-26T02:05:13.000Z"},"item":[{"name":"Activities","id":"0913e0b9-9cb5-440e-9d8d-bf6430285ee9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"{{apiKey}}","description":"API key provided by Challenge Hound
\n","type":"text"}],"url":"https://api.challengehound.com/v1/activities?challengeId={{challengeId}}","urlObject":{"protocol":"https","path":["v1","activities"],"host":["api","challengehound","com"],"query":[{"description":{"content":"Optional challengeId - will query activities in the provided challenge. Do not provide groupId if challengeId is present
\n","type":"text/plain"},"key":"challengeId","value":"{{challengeId}}"},{"disabled":true,"description":{"content":"Optional groupId - will query activities in provided group. Do you provide challengeId if groupId is present
\n","type":"text/plain"},"key":"groupId","value":"{{groupId}}"},{"disabled":true,"description":{"content":"Optional userId - will query based on user
\n","type":"text/plain"},"key":"userId","value":"{{userId}}"},{"disabled":true,"description":{"content":"Optional number of results to return (default 50)
\n","type":"text/plain"},"key":"size","value":"{{size}}"},{"disabled":true,"description":{"content":"Optional page number (default 0)
\n","type":"text/plain"},"key":"page","value":"{{page}}"},{"disabled":true,"description":{"content":"Optional order or sort (default start desc)
\n","type":"text/plain"},"key":"orderBy","value":"{{orderBy}}"},{"disabled":true,"description":{"content":"Optional true/false boolean. True rolls up results per particiapnt with totals. True also changes output to simple array vs an object with results and totals.
\n","type":"text/plain"},"key":"aggregates","value":"{{aggregates}}"}],"variable":[]}},"response":[{"id":"4b09592a-491a-4bc3-8cc6-f60eb1d56336","name":"Activities","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{apiKey}}","description":"API key provided by Challenge Hound","type":"text"}],"url":{"raw":"https://api.challengehound.com/v1/activities?challengeId={{challengeId}}","protocol":"https","host":["api","challengehound","com"],"path":["v1","activities"],"query":[{"key":"challengeId","value":"{{challengeId}}","description":"Optional challengeId - will query activities in the provided challenge. Do not provide groupId if challengeId is present"},{"key":"groupId","value":"{{groupId}}","description":"Optional groupId - will query activities in provided group. Do you provide challengeId if groupId is present","disabled":true},{"key":"userId","value":"{{userId}}","description":"Optional userId - will query based on user ","disabled":true},{"key":"size","value":"{{size}}","description":"Optional number of results to return (default 50)","disabled":true},{"key":"page","value":"{{page}}","description":"Optional page number (default 0)","disabled":true},{"key":"orderBy","value":"{{orderBy}}","description":"Optional order or sort (default start desc)","disabled":true},{"key":"aggregates","value":"{{aggregates}}","description":"Optional true/false boolean. True rolls up results per particiapnt with totals.","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"3210"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 27 Jul 2022 11:45:58 GMT"},{"key":"x-amzn-RequestId","value":"efe28e63-6710-4d6c-96a0-7ef199ec4aa0"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"x-amzn-Remapped-content-length","value":"18028"},{"key":"x-amz-apigw-id","value":"V7LJ6HDqPHcFYVQ="},{"key":"etag","value":"W/\"466c-1JW+X0bT9MhzpOJc9HJT9tQKAmE\""},{"key":"x-powered-by","value":"Express"},{"key":"X-Amzn-Trace-Id","value":"Root=1-62e12572-3b08fbf941e9d5fa63a9367b;Sampled=0"},{"key":"access-control-allow-credentials","value":"true"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 95edb2a6efdb5ee4d3c7f7aa298bb2f2.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR53-P1"},{"key":"X-Amz-Cf-Id","value":"oz9hgT4rR-HDvC3u6-byKWQIwJbelwdFDii2lAMDdtHfPQywcIQJEQ=="}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 2,\n \"results\": [\n {\n \"userId\": \"074be1d0-b530-11e6-b0c0-e5c6cda8e513\",\n \"activityId\": \"21219ea0-0cec-11ed-b60b-0122ed53f22b\",\n \"participant\": \"V Shreve\",\n\t\t\t\t\t\t\"participantPhoto\": \"https://cdn.challengehound.com/profile/e05eca40-aa9d-11ee-8a6f-e39cf7a9fea5.png\",\n \"date\": \"07/26/2022\",\n \"datetime\": \"2022-07-26T13:49:22Z\",\n \"name\": \"Morning Run\",\n \"type\": \"run\",\n \"app\": \"strava\",\n \"durationSeconds\": 840,\n \"distanceKilometers\": \"1.39\",\n \"distanceMiles\": \"0.86\",\n \"elevationMeters\": \"0.00\",\n \"elevationFeet\": \"0.00\"\n },\n {\n \"userId\": \"074c2ff0-b530-11e6-b0c0-e5c6cda8e513\",\n \"activityId\": \"cf2d5760-0ce6-11ed-ba76-add345c6cf79\",\n \"participant\": \"Justin Shreve 🏔\",\n \"participantPhoto\": \"https://cdn.challengehound.com/profile/e05eca40-aa9d-11ee-8a6f-e39cf7a9fea5.png\",\n\t\t\t\t\t\t\"date\": \"07/26/2022\",\n \"datetime\": \"2022-07-26T11:31:37Z\",\n \"name\": \"Spry Run\",\n \"type\": \"run\",\n \"app\": \"coros\",\n \"durationSeconds\": 1253,\n \"distanceKilometers\": \"4.18\",\n \"distanceMiles\": \"2.60\",\n \"elevationMeters\": \"86.00\",\n \"elevationFeet\": \"282.15\"\n }\n ]\n}"}],"_postman_id":"0913e0b9-9cb5-440e-9d8d-bf6430285ee9"},{"name":"Challenge Totals","id":"3673a6ba-1fd0-4266-9af8-3ae2f72db4fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{apiKey}}","type":"text"}],"url":"https://api.challengehound.com/v1/challenges/{{challengeId}}/totals","description":"Get the overall totals for a challenge.
\n","urlObject":{"protocol":"https","path":["v1","challenges","{{challengeId}}","totals"],"host":["api","challengehound","com"],"query":[],"variable":[]}},"response":[{"id":"b3daff24-cbda-400d-9253-557736e23eb3","name":"Totals","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{apiKey}}","type":"text"}],"url":"https://api.challengehound.com/v1/challenges/{{challengeId}}/totals"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"438"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 02 Sep 2022 13:01:13 GMT"},{"key":"x-amzn-RequestId","value":"64878f74-85ef-43f9-a17f-7288b0079940"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-amzn-Remapped-content-length","value":"438"},{"key":"x-amz-apigw-id","value":"X1S32E3DvHcFzxA="},{"key":"etag","value":"W/\"1b6-sV/zAFydHhgHJnDiGmGvmTiuW+g\""},{"key":"x-powered-by","value":"Express"},{"key":"X-Amzn-Trace-Id","value":"Root=1-6311fe98-7e50fd241ae9e0d66a2c32e8;Sampled=0"},{"key":"access-control-allow-credentials","value":"true"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 7972cbd1699f1a8b6ef2e0b1fa50ca3e.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR52-C3"},{"key":"X-Amz-Cf-Id","value":"UHnYTVkZwJb1is0kbLYKT2L4YvuY31L8ZyLWx3bi05wJM_ZqHBZpSg=="}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"50620d20-6405-11ec-ae02-f9496eab9216\",\n \"challengeName\": \"2022 run365 public\",\n \"measure\": \"distance\",\n \"distanceKilometers\": 587.41,\n \"distanceMiles\": 365,\n \"elevationMeters\": 0,\n \"elevationFeet\": 0,\n \"activityGoal\": null,\n \"durationGoal\": null,\n \"pointGoal\": null,\n \"totals\": {\n \"distanceKilometers\": 97085.89,\n \"distanceMiles\": 60326.37,\n \"elevationMeters\": 0,\n \"elevationFeet\": 2707823.97,\n \"durationSeconds\": 69077870,\n \"points\": null,\n \"activities\": 21707,\n \"participants\": 380\n }\n}"}],"_postman_id":"3673a6ba-1fd0-4266-9af8-3ae2f72db4fa"},{"name":"Challenge Participants","id":"a01a1ae8-6b05-4810-ad70-1c0a74f5e7e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{apiKey}}","type":"text"}],"url":"https://api.challengehound.com/v1/challenges/{{challengeId}}/participants","description":"Use this to get a list of all participants in a challenge, whether they've logged an activity or not. This can be userful before a challenge starts, or to get participants that have not logged an activity.
\n","urlObject":{"protocol":"https","path":["v1","challenges","{{challengeId}}","participants"],"host":["api","challengehound","com"],"query":[],"variable":[]}},"response":[{"id":"9cc12d32-34d9-4edc-be9d-f0137834d49f","name":"Participants","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"KfrLN6jnch5lz65SKdTWw9Ozq5TJD1me7ymZTATq","type":"text"}],"url":"https://api.challengehound.com/v1/challenges/{{challengeId}}/participants"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"388"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Tue, 30 Jul 2024 23:01:37 GMT"},{"key":"access-control-allow-credentials","value":"true"},{"key":"x-amzn-RequestId","value":"53f5ad13-bdeb-4b1f-94e9-1fc0245302ed"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-amzn-Remapped-content-length","value":"388"},{"key":"x-amz-apigw-id","value":"bv6PwFyCPHcEnIQ="},{"key":"etag","value":"W/\"184-qon+xGlDS8so4ZRB7txmEJJdEaI\""},{"key":"x-powered-by","value":"Express"},{"key":"X-Amzn-Trace-Id","value":"Root=1-66a970ca-1895ec174de620121633baac;Parent=7766702ee35131bd;Sampled=0;lineage=522d6996:0|f5109c0d:0"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 6e01480ef7aa01c23bf600698a613304.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR53-P1"},{"key":"X-Amz-Cf-Id","value":"Y5VZa38oL0xt1AeyX_yWcA5lYbmK8HNOzlQbPQFxm0Kb6wzex_IAig=="}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"812cff1431e2-b530-11e6-b0c0-812cff1431e2\",\n \"fullname\": \"Larry Jounce\",\n \"fname\": \"Larry\",\n \"lname\": \"Jounce\",\n \"photo\": null,\n \"joined\": \"2021-12-24T13:02:36.000Z\"\n },\n {\n \"id\": \"54d81080-c532-11e6-9d8a-812fff1431e2\",\n \"fullname\": \"Jane Gold\",\n \"fname\": \"Jane\",\n \"lname\": \"Gold\",\n \"photo\": \"https://some.cloudfront.net/pictures/athletes/medium.jpg\",\n \"joined\": \"2021-12-28T23:17:44.000Z\"\n }\n]"}],"_postman_id":"a01a1ae8-6b05-4810-ad70-1c0a74f5e7e2"},{"name":"Challenges By Group","id":"bfb742b7-c244-4e2b-8d7b-4f13faa9d383","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{apiKey}}","type":"text"}],"url":"https://api.challengehound.com/v1/challenges?groupId={{groupId}}","description":"Get a list of challenges within a group.
\n","urlObject":{"protocol":"https","path":["v1","challenges"],"host":["api","challengehound","com"],"query":[{"key":"groupId","value":"{{groupId}}"}],"variable":[]}},"response":[{"id":"2cc27091-c410-4dd3-bc74-b28e4b2dcd02","name":"List","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"KfrLN6jnch5lz65SKdTWw9Ozq5TJD1me7ymZTATq","type":"text"}],"url":{"raw":"https://api.challengehound.com/v1/challenges?groupId=8cdca331-87c0-11e7-bd8f-a920253c4ac5","protocol":"https","host":["api","challengehound","com"],"path":["v1","challenges"],"query":[{"key":"groupId","value":"8cdca331-87c0-11e7-bd8f-a920253c4ac5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1225"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Fri, 04 Aug 2023 01:17:43 GMT"},{"key":"x-amzn-RequestId","value":"4bfa30b0-a636-45c5-abfc-eb4b54ab5119"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"gzip"},{"key":"x-amzn-Remapped-content-length","value":"3901"},{"key":"x-amz-apigw-id","value":"JHGzpHqMPHcFuKA="},{"key":"etag","value":"W/\"f3d-CFVlcrTlaXeLgm9zbjUMKf4C9II\""},{"key":"x-powered-by","value":"Express"},{"key":"X-Amzn-Trace-Id","value":"Root=1-64cc51b0-740ede335611a3cb6767fabd;Sampled=0;lineage=522d6996:0|f5109c0d:0"},{"key":"access-control-allow-credentials","value":"true"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 bd83fc15ab125846f839dd3c1ad21462.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"JFK50-P4"},{"key":"X-Amz-Cf-Id","value":"njPnidRhdJLJ-bqEeq3otfluKRf7D9I1sjGEConHgKZ-VoDiU1Me1g=="}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"f2f26640-c08e-11e6-aa26-2df1980bb415\",\n \"challengeName\": \"A Test Challenge\",\n \"challengeDesc\": \"Tis the season for a test challenge\",\n \"measure\": \"distance\",\n \"start\": \"2016-12-12T00:00:00.000Z\",\n \"end\": \"2016-12-25T23:59:00.000Z\",\n \"isOver\": true,\n \"daysLeft\": 0,\n \"dayOfChallenge\": 14,\n \"timezone\": null,\n \"distanceGoalKilometers\": 19.31,\n \"distanceGoalMiles\": 12,\n \"elevationGoalMeters\": 0,\n \"elevationGoalFeet\": 0,\n \"activityGoal\": null,\n \"durationGoal\": null,\n \"pointGoal\": null,\n \"streakGoal\": null\n }\n]"}],"_postman_id":"bfb742b7-c244-4e2b-8d7b-4f13faa9d383"}]}