---
title: API Reference
slug: api-reference
icon: 📘
createdAt: 2026-10-28T08:14:05.349Z
---

Every MomentScience API on one page, with what each one is for. Most endpoints sit on `https://api.adspostx.com`. Each API page covers authentication, parameters and sample responses, and several have a Try it console for sending a live request.

## APIs

| **API**                                                 | **Use it to**                                                                             | **Endpoint**                       |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------- |
| [MomentPerks API](docId\:zpOL4DX0Bohl2AOoyZrLQ)         | Fetch personalized offers for one user and show them in your own UI.                      | `POST /native/v4/offers.json`      |
| [Perkswall API](docId:2un6uWR7-uyB7cTVyHYy_)            | Fetch a curated set of offers for a branded perks gallery.                                | `POST /native/v4/perkswall.json`   |
| [DirectPerks API](docId\:X-Trc9-DEbSkVhrlRTGOR)         | Get every active offer on your account, with creatives and tracking links.                | `GET /native/v3/catalog.json`      |
| [Reporting API](docId\:WnXQq5uqvdBwdx-nikAWO)           | Pull revenue, impressions, clicks and CTR, by day or by hour.                             | `GET /native/activity.json`        |
| [Create Sub-Accounts API](docId\:tO43JwBDh_fKaCHNLbO5t) | Create sub-accounts under your main account, with copied settings and scoped permissions. | `POST /native/account.json`        |
| [User Selected Perks API](docId\:K8C2d-0Rpuh46pXjFRxIE) | Build your own User Selected Perks flow, from session to saved offers.                    | `/sdk/v4/usp/` (several endpoints) |

## Before your first call

Every request needs an API key. [Getting Your API Key](docId\:CD0hKzWhbqxqwKYfO_cZG) shows how to create one and which permissions each API needs. When a request fails, [API Error Codes](docId\:H32hx45Y3X9ZdXApVijRN) lists the status codes the APIs return and how to handle each one.

## Postbacks

Postbacks run the other way. [Handling Postback Events](docId\:U6s7GlbRWPW4hb3zP9xJm) covers the notifications MomentScience sends to your server when a user converts. Advertisers who send conversions to MomentScience should read [Server-to-Server (S2S) Postback Integration](docId\:fyISA7EQM33yyvaaJfCfO).

## Mobile apps

Calling the MomentPerks API from a mobile app? There is a step-by-step guide for each platform: [Android (Kotlin)](docId\:bTtdlBYFHOIkOoqd9Em01), [iOS (Swift)](docId:_6D5ibwY5Ckyh5k4AUBhG), [Flutter](docId\:onsCA-NlL3y_5Ow2r1R9e), [React Native](docId\:yImpctt6vt6WTNWMP_ybZ) and [Unity](docId:7QbvdkwS9fyYkiTbTluDs).

