Rebrickable API

We have several web services for directly accessing the various Rebrickable functions and data from your own applications or web sites. To be able to use these, you must first Generate an API Key from your profile's settings page (if you don't already have an account sign up here).

These functions act on a specified user account:
These are general set inventory functions:
  • Get Set Parts - Get a list of all parts (normal + spare) used in a set.
  • Get Part - Get details about a specific part.
  • Get Element - Get details about a specific LEGO element ID (ie part design and color).
  • Get Set - Get details about a specific set.
  • Get Part Sets - Get the list of sets that a specific part/color appears in.
  • Get Colors - Get the list of colors used by all parts.
  • Get Changes - Get the list of set/part changes since some point in time.
  • Get Alternate Build MOCs - Get a list of MOCs that are alternate builds of the specific set.
  • Search - List Sets or Parts that match the search criteria.

Change History

2014-12-12 - get_part - Added optional parameter inc_colors if you dont need the part colors data.
2014-11-29 - get_part - Removed rebrickable_id output field (which wasn't working 100% correctly) and replaced it with rebrickable_ids array which can return multiple alternate parts to use instead of the requested part id.
2014-11-23 - search - Fixed doco for type parameter, increased results to 1000.
2014-11-22 - all functions - Added optional JSONP callback parameter to allow calling the API via ajax.
2014-11-22 - search - Created function.
2014-11-22 - get_part_types - Created function to list all part type codes and descriptsions (aka part categories).
2014-11-22 - get_user_set - Fix bug preventing data being returned for sets not in setlist #1.
2014-11-16 - get_changes - Added optional type parameter to filter output.
2014-10-29 - get_colors - Fixed duplicated json output, now valid json.
2014-10-20 - get_element - Created function.
2014-10-18 - get_alt_builds - Added num_parts field.
2014-10-16 - get_alt_builds - Added CSV format.
2014-10-16 - get_user_sets - Fixed output formatting when no format parameter supplied.
2014-09-30 - get_alt_builds - Added image fields to result.
2014-09-12 - get_alt_builds - Created function.
2014-09-07 - get_changes - Created function.
2014-08-01 - get_part - Now returns rebrickable_part_id when available even if the requested part doesn't exist (e.g. LDD part 74741 -> Rebrickable part 2909c03).
2014-07-07 - get_part - Added additional return field: rebrickable_part_id.
2014-06-01 - get_colors - Fixed XML output.
2014-05-03 - get_part - Added additional return field: category.
2014-05-03 - get_set - Created function.
2014-05-03 - get_user_last_change - Created function.
2014-03-05 - get_set_parts - Added additional return fields: element_id, element_img_url.
2014-01-25 - get_part - Added optional parameters inc_rels and inc_ext to return additional part relationships and external part id information.
2013-11-25 - get_user_sets - Added additional return fields: #pieces, description, year, thumbnail image url.
2013-11-23 - set_user_lost_parts - Created function.
2013-11-23 - get_user_lost_parts - Created function.
2013-09-16 - get_set_parts - Fixed problem with part_img_url field for spare parts.
2013-05-06 - get_user_sets - Added optional setlist_id parameter.
2013-05-04 - set_user_sets - Added optional setlist_id parameter.
2013-05-04 - set_user_setlists - Created function.
2013-04-07 - set_user_parts/get_user_parts - Created new functions.
2013-04-03 - get_user_hash - Created function and updated all other user functions to accept the user_hash parameter as an alternative to email/pass.
2013-04-01 - get_set_parts - Added additional return fields: set_img_url, part_name, color_name, part_img_url.
2013-04-01 - get_part - Created function.
2013-04-01 - get_part_sets - Created function.
2013-04-01 - get_colors - Created function.