campaign Take the new survey for 100 robux: https://imfone.dev/survey

Public API

Read public Solar data from your own tools. Base URL: /api/public/v1
  • Everything is read-only GET and needs no key or login. Responses are JSON, and CORS is open for GET so browsers can call it from any site.
  • Each IP address may make 60 requests per minute. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (seconds). Past the limit you get HTTP 429 with a Retry-After header.
  • Errors look like {"success":false,"error":"..."} with status 400, 404, 405 or 429.
  • Only public data is returned: no emails, IP addresses, Discord accounts, balances, private games or private items, and banned users are treated as missing. Names and descriptions are plain text, not HTML.
  • Thumbnail URLs are stable and can be used in an img tag.
GET/api/public/v1/users

Lists users, oldest first. Banned users are never listed.

qOptional. Part of a username.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/users?q=sol&limit=2"
Example response
{"success":true,"page":1,"limit":25,"total":126,"data":[{"id":1,"username":"Solar","created":"2025-07-05 01:32:21","thumbnails":{"headshot":"...","avatar":"..."},"profileUrl":"https://imfone.dev/user/1"}]}
GET/api/public/v1/users/{id}

One user by ID.

idUser ID.
Example request
curl "https://imfone.dev/api/public/v1/users/1"
Example response
{"success":true,"data":{"id":1,"username":"Solar","created":"2025-07-05 01:32:21","thumbnails":{"headshot":"https://imfone.dev/image/headshot?id=1","avatar":"https://imfone.dev/thumbnail/user/1"},"profileUrl":"https://imfone.dev/user/1","description":"...","friendCount":249,"badgeCount":3}}
GET/api/public/v1/users/by-name/{name}

One user by exact username (not case sensitive). Same response as /users/{id}.

nameUsername.
Example request
curl "https://imfone.dev/api/public/v1/users/by-name/Solar"
Example response
{"success":true,"data":{"id":1,"username":"Solar","created":"2025-07-05 01:32:21","thumbnails":{"headshot":"https://imfone.dev/image/headshot?id=1","avatar":"https://imfone.dev/thumbnail/user/1"},"profileUrl":"https://imfone.dev/user/1","description":"...","friendCount":249,"badgeCount":3}}
GET/api/public/v1/users/{id}/friends

The user's accepted friends.

idUser ID.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/users/1/friends?limit=2"
Example response
{"success":true,"page":1,"limit":25,"total":126,"data":[{"id":1,"username":"Solar","created":"2025-07-05 01:32:21","thumbnails":{"headshot":"...","avatar":"..."},"profileUrl":"https://imfone.dev/user/1"}]}
GET/api/public/v1/users/{id}/presence

Whether the user is offline, online on the website, editing in Studio or playing. The game is shown only if it is public.

idUser ID.
Example request
curl "https://imfone.dev/api/public/v1/users/1/presence"
Example response
{"success":true,"data":{"userId":1,"status":"playing","place":{"id":11,"name":"Flood Escape (2010)","url":"https://imfone.dev/game/11"}}}
GET/api/public/v1/users/{id}/badges

Badges the user has earned, newest first.

idUser ID.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/users/1/badges"
Example response
{"success":true,"page":1,"limit":25,"total":3,"data":[{"id":195,"name":"Welcome to Flood Escape!","description":"...","gameId":11,"thumbnail":"https://imfone.dev/Image/Item.ashx?ID=195","awarded":"2026-06-05 17:52:16"}]}
GET/api/public/v1/limiteds

Lists approved, public limited items with their original price, copies in circulation, RAP (recent average price, null until the first paid sale), the lowest current resale price and the number of resellers. Staff listings are never counted, because staff cannot resell.

qOptional. Part of the name.
sortnew (default), rap, price (lowest resale first), copies or resellers.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/limiteds?sort=rap&limit=2"
Example response
{"success":true,"page":1,"limit":25,"total":126,"data":[{"id":123,"name":"Homeless","type":"Face","unique":false,"creator":{"id":1,"username":"Solar"},"originalPriceRobux":0,"onSale":false,"copies":19,"maxCopies":null,"remaining":null,"rap":100,"lowestResalePrice":1000,"resellerCount":1,"thumbnail":"https://imfone.dev/Image/Item.ashx?ID=123","url":"https://imfone.dev/item/123"}]}
GET/api/public/v1/limiteds/{id}

One limited item with its last 25 resale prices and its RAP history. Sales list only price and time, never the buyer or seller.

idItem ID.
Example request
curl "https://imfone.dev/api/public/v1/limiteds/123"
Example response
{"success":true,"data":{"id":123,"name":"Homeless","type":"Face","unique":false,"creator":{"id":1,"username":"Solar"},"originalPriceRobux":0,"onSale":false,"copies":19,"maxCopies":null,"remaining":null,"rap":100,"lowestResalePrice":1000,"resellerCount":1,"thumbnail":"https://imfone.dev/Image/Item.ashx?ID=123","url":"https://imfone.dev/item/123","description":"...","totalSales":20,"created":"2026-06-02 23:22:54","recentSales":[{"price":1000,"time":"2026-11-10T12:00:00Z"}],"rapHistory":[{"rap":100,"time":"2026-11-10T12:00:00Z"}]}}
GET/api/public/v1/limiteds/{id}/resellers

Current resale listings, cheapest first, with the serial number and the seller.

idItem ID.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/limiteds/123/resellers"
Example response
{"success":true,"page":1,"limit":25,"total":1,"data":[{"serial":12,"price":1000,"seller":{"id":76,"username":"xs08c"}}]}
GET/api/public/v1/limiteds/{id}/owners

Every serial and its current owner, in serial order. Serials owned by banned users are left out.

idItem ID.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/limiteds/123/owners?limit=2"
Example response
{"success":true,"page":1,"limit":2,"total":19,"data":[{"serial":1,"ownedSince":"2026-06-02 23:23:20","owner":{"id":16,"username":"pwnzor"}}]}
GET/api/public/v1/users/{id}/inventory

Public, approved items the user owns. Inventories are public on Solar, so there is no privacy setting to respect.

idUser ID.
typeOptional. Hat, Gear, Face, Head, Shirt, Pants, ShirtGraphic, Torso, LeftArm, RightArm, LeftLeg, RightLeg, CharacterMesh or AnimationPack.
limitedOptional. 1 for limited items only.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/users/1/inventory?type=Face&limit=2"
Example response
{"success":true,"page":1,"limit":25,"total":126,"data":[{"id":1941,"name":"Mesh Face","type":"Face","limited":false,"serial":null,"thumbnail":"https://imfone.dev/Image/Item.ashx?ID=1941","url":"https://imfone.dev/item/1941"}]}
GET/api/public/v1/users/{id}/limiteds

Limited serials the user owns, highest RAP first.

idUser ID.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/users/1/limiteds"
Example response
{"success":true,"page":1,"limit":25,"total":1,"data":[{"id":123,"name":"Homeless","type":"Face","serial":12,"rap":100,"originalPrice":0,"ownedSince":"2026-06-02 23:23:20","thumbnail":"...","url":"https://imfone.dev/item/123"}]}
GET/api/public/v1/users/{id}/rap

The total RAP of the limiteds the user owns, and how many.

idUser ID.
Example request
curl "https://imfone.dev/api/public/v1/users/1/rap"
Example response
{"success":true,"data":{"userId":1,"limitedCount":4,"totalRap":1250}}
GET/api/public/v1/games

Lists public, approved games.

qOptional. Part of the name.
sortnew (default), popular or playing.
clientOptional. 2012 or 2018.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/games?sort=popular&limit=2"
Example response
{"success":true,"page":1,"limit":25,"total":126,"data":[{"id":11,"name":"Flood Escape (2010)","description":"Escape the Floods!","creator":{"id":1,"username":"Solar"},"created":"2026-05-30 21:40:00","updated":"2026-11-09 10:34:29","visits":35,"playing":0,"likes":2,"dislikes":2,"clientVersion":2012,"maxPlayers":20,"thumbnail":"https://imfone.dev/Image/Item.ashx?ID=11","url":"https://imfone.dev/game/11"}]}
GET/api/public/v1/games/{id}

One public game with its visit, player and vote counts.

idGame ID.
Example request
curl "https://imfone.dev/api/public/v1/games/11"
Example response
{"success":true,"data":{"id":11,"name":"Flood Escape (2010)","description":"Escape the Floods!","creator":{"id":1,"username":"Solar"},"created":"2026-05-30 21:40:00","updated":"2026-11-09 10:34:29","visits":35,"playing":0,"likes":2,"dislikes":2,"clientVersion":2012,"maxPlayers":20,"thumbnail":"https://imfone.dev/Image/Item.ashx?ID=11","url":"https://imfone.dev/game/11"}}
GET/api/public/v1/games/{id}/badges

Badges that belong to the game.

idGame ID.
Example request
curl "https://imfone.dev/api/public/v1/games/11/badges"
Example response
{"success":true,"data":[{"id":195,"name":"Welcome to Flood Escape!","description":"...","gameId":11,"thumbnail":"https://imfone.dev/Image/Item.ashx?ID=195"}]}
GET/api/public/v1/catalog

Lists approved catalog items that are on sale or limited.

qOptional. Part of the name.
typeOptional. Hat, Gear, Face, Head, Shirt, Pants, ShirtGraphic, Torso, LeftArm, RightArm, LeftLeg, RightLeg, CharacterMesh or AnimationPack.
sortnew (default), popular or cheapest.
limitedOptional. 1 for limited items only.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/catalog?type=Hat&limit=2"
Example response
{"success":true,"page":1,"limit":25,"total":126,"data":[{"id":1929,"name":"Gamaboi","description":"...","type":"Gear","creator":{"id":1,"username":"Solar"},"priceRobux":400,"priceTix":0,"onSale":true,"limited":false,"sales":0,"created":"2026-11-18 19:19:16","updated":"2026-11-18 19:19:16","thumbnail":"https://imfone.dev/Image/Item.ashx?ID=1929","url":"https://imfone.dev/item/1929"}]}
GET/api/public/v1/catalog/{id}

One approved, public catalog item (also when it is off sale).

idItem ID.
Example request
curl "https://imfone.dev/api/public/v1/catalog/1929"
Example response
{"success":true,"data":{"id":1929,"name":"Gamaboi","description":"...","type":"Gear","creator":{"id":1,"username":"Solar"},"priceRobux":400,"priceTix":0,"onSale":true,"limited":false,"sales":0,"created":"2026-11-18 19:19:16","updated":"2026-11-18 19:19:16","thumbnail":"https://imfone.dev/Image/Item.ashx?ID=1929","url":"https://imfone.dev/item/1929"}}
GET/api/public/v1/groups

Lists groups, largest first.

qOptional. Part of the name.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/groups?limit=2"
Example response
{"success":true,"page":1,"limit":25,"total":126,"data":[{"id":1,"name":"Official Solar Group","description":"Join for Solar","owner":{"id":1,"username":"Solar"},"memberCount":25,"created":"2026-05-30 16:15:39","shout":"...","icon":"https://imfone.dev/api/group/icon?id=1","url":"https://imfone.dev/group/1"}]}
GET/api/public/v1/groups/{id}

One group with its member count and shout.

idGroup ID.
Example request
curl "https://imfone.dev/api/public/v1/groups/1"
Example response
{"success":true,"data":{"id":1,"name":"Official Solar Group","description":"Join for Solar","owner":{"id":1,"username":"Solar"},"memberCount":25,"created":"2026-05-30 16:15:39","shout":"...","icon":"https://imfone.dev/api/group/icon?id=1","url":"https://imfone.dev/group/1"}}
GET/api/public/v1/channels

Lists the client release channels and the web client version each one serves. live is Chocolate for everyone; developer is the Swirl client for developers.

Example request
curl "https://imfone.dev/api/public/v1/channels"
Example response
{"success":true,"data":[{"name":"developer","title":"Developer","description":"Early builds of the Swirl client for developers.","client":"swirl","currentVersion":"1.13","releasedAt":"2026-11-21T19:20:15+00:00"}]}
GET/api/public/v1/channels/{name}

One channel with its current web version, its current desktop launcher and client per era and platform, and how many releases it has.

nameChannel name, e.g. live or developer.
Example request
curl "https://imfone.dev/api/public/v1/channels/developer"
Example response
{"success":true,"data":{"name":"developer","client":"swirl","currentVersion":"1.13","desktop":[{"era":2012,"platform":"linux-x64","kind":"client","version":"1.0","releasedAt":"2026-11-21T15:28:44+00:00"}],"releaseCount":18}}
GET/api/public/v1/channels/{name}/releases

Every release on a channel, newest first. Desktop releases also carry era, platform and kind (client or bootstrapper).

nameChannel name.
pagePage number, starting at 1.
limitResults per page, 1 to 50 (default 25).
Example request
curl "https://imfone.dev/api/public/v1/channels/developer/releases?limit=1"
Example response
{"success":true,"channel":"developer","page":1,"limit":1,"total":18,"data":[{"version":"1.13","client":"swirl","notes":"Tools, clothing and chat","releasedAt":"2026-11-21T19:20:15+00:00","current":true}]}
GET/api/public/v1/channels/{name}/releases/{version}

Every build released as that version on the channel: the web client and any desktop launchers and clients.

nameChannel name.
versionVersion, e.g. 1.13.
Example request
curl "https://imfone.dev/api/public/v1/channels/developer/releases/1.13"
Example response
{"success":true,"channel":"developer","version":"1.13","data":[{"version":"1.13","client":"swirl","notes":"Tools, clothing and chat","releasedAt":"2026-11-21T19:20:15+00:00","current":true}]}
GET/api/public/v1/versions

The current version of everything at once: for each channel, the web client version and the current desktop launchers and clients.

Example request
curl "https://imfone.dev/api/public/v1/versions"
Example response
{"success":true,"data":[{"channel":"developer","client":"swirl","web":"1.13","desktop":[{"era":2012,"platform":"linux-x64","kind":"client","version":"1.0","releasedAt":"2026-11-21T15:28:44+00:00"}]}]}