curl --request GET \
--url https://api.hubapi.com/companies/v2/companies/recent/created
"\nExample URL to GET:\nhttps://api.hubapi.com/companies/v2/companies/recent/created\n\nExample JSON Response:\n{\n \"results\": [\n {\n \"portalId\": 62515,\n \"companyId\": 19411477,\n \"isDeleted\": false,\n \"properties\": {\n \"hs_analytics_num_visits\": {\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_num_visits\",\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"first_deal_created_date\": {\n \"value\": \"1419966041287\",\n \"timestamp\": 1419966041656,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"first_deal_created_date\",\n \"value\": \"1419966041287\",\n \"timestamp\": 1419966041656,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_lastmodifieddate\": {\n \"value\": \"1419968097561\",\n \"timestamp\": 1419968097561,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_lastmodifieddate\",\n \"value\": \"1419968097561\",\n \"timestamp\": 1419968097561,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"recent_deal_close_date\": {\n \"value\": \"1415689200000\",\n \"timestamp\": 1419966061962,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"recent_deal_close_date\",\n \"value\": \"1415689200000\",\n \"timestamp\": 1419966061962,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"recent_deal_amount\": {\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"recent_deal_amount\",\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"closedate\": {\n \"value\": \"1415682000000\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"closedate\",\n \"value\": \"1415682000000\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"createdate\": {\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"createdate\",\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hubspot_owner_assigneddate\": {\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hubspot_owner_assigneddate\",\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"first_contact_createdate\": {\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"first_contact_createdate\",\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"lifecyclestage\": {\n \"value\": \"customer\",\n \"timestamp\": 1419966061791,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"lifecyclestage\",\n \"value\": \"customer\",\n \"timestamp\": 1419966061791,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"total_revenue\": {\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"total_revenue\",\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_source\": {\n \"value\": \"OFFLINE\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_source\",\n \"value\": \"OFFLINE\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_num_page_views\": {\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_num_page_views\",\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_first_timestamp\": {\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_first_timestamp\",\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"name\": {\n \"value\": \"madison Inc\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"name\",\n \"value\": \"madison Inc\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"num_associated_contacts\": {\n \"value\": \"1\",\n \"timestamp\": 1419966011133,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"num_associated_contacts\",\n \"value\": \"1\",\n \"timestamp\": 1419966011133,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hubspot_owner_id\": {\n \"value\": \"70\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hubspot_owner_id\",\n \"value\": \"70\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"num_associated_deals\": {\n \"value\": \"1\",\n \"timestamp\": 1419966041656,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"num_associated_deals\",\n \"value\": \"1\",\n \"timestamp\": 1419966041656,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_source_data_2\": {\n \"value\": \"\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_source_data_2\",\n \"value\": \"\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_source_data_1\": {\n \"value\": \"API\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_source_data_1\",\n \"value\": \"API\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n }\n }\n },\n \n }\n],\n\"hasMore\": false,\n\"offset\": 4,\n\"total\": 4\n}"
This endpoint is used to search for companies by domain name. Use case for this endpoint: This can be used to search for existing companies based on an exact match to the domain property.
curl --request GET \
--url https://api.hubapi.com/companies/v2/companies/recent/created
"\nExample URL to GET:\nhttps://api.hubapi.com/companies/v2/companies/recent/created\n\nExample JSON Response:\n{\n \"results\": [\n {\n \"portalId\": 62515,\n \"companyId\": 19411477,\n \"isDeleted\": false,\n \"properties\": {\n \"hs_analytics_num_visits\": {\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_num_visits\",\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"first_deal_created_date\": {\n \"value\": \"1419966041287\",\n \"timestamp\": 1419966041656,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"first_deal_created_date\",\n \"value\": \"1419966041287\",\n \"timestamp\": 1419966041656,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_lastmodifieddate\": {\n \"value\": \"1419968097561\",\n \"timestamp\": 1419968097561,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_lastmodifieddate\",\n \"value\": \"1419968097561\",\n \"timestamp\": 1419968097561,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"recent_deal_close_date\": {\n \"value\": \"1415689200000\",\n \"timestamp\": 1419966061962,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"recent_deal_close_date\",\n \"value\": \"1415689200000\",\n \"timestamp\": 1419966061962,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"recent_deal_amount\": {\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"recent_deal_amount\",\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"closedate\": {\n \"value\": \"1415682000000\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"closedate\",\n \"value\": \"1415682000000\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"createdate\": {\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"createdate\",\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hubspot_owner_assigneddate\": {\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hubspot_owner_assigneddate\",\n \"value\": \"1419966010576\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"first_contact_createdate\": {\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"first_contact_createdate\",\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"lifecyclestage\": {\n \"value\": \"customer\",\n \"timestamp\": 1419966061791,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"lifecyclestage\",\n \"value\": \"customer\",\n \"timestamp\": 1419966061791,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"total_revenue\": {\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"total_revenue\",\n \"value\": \"5000\",\n \"timestamp\": 1419966061962,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_source\": {\n \"value\": \"OFFLINE\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_source\",\n \"value\": \"OFFLINE\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_num_page_views\": {\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_num_page_views\",\n \"value\": \"0\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_first_timestamp\": {\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_first_timestamp\",\n \"value\": \"1419965931323\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"name\": {\n \"value\": \"madison Inc\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"name\",\n \"value\": \"madison Inc\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"num_associated_contacts\": {\n \"value\": \"1\",\n \"timestamp\": 1419966011133,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"num_associated_contacts\",\n \"value\": \"1\",\n \"timestamp\": 1419966011133,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hubspot_owner_id\": {\n \"value\": \"70\",\n \"timestamp\": 1419966010576,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hubspot_owner_id\",\n \"value\": \"70\",\n \"timestamp\": 1419966010576,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"num_associated_deals\": {\n \"value\": \"1\",\n \"timestamp\": 1419966041656,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"num_associated_deals\",\n \"value\": \"1\",\n \"timestamp\": 1419966041656,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_source_data_2\": {\n \"value\": \"\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_source_data_2\",\n \"value\": \"\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n },\n \"hs_analytics_source_data_1\": {\n \"value\": \"API\",\n \"timestamp\": 1419968066626,\n \"source\": null,\n \"sourceId\": null,\n \"versions\": [\n {\n \"name\": \"hs_analytics_source_data_1\",\n \"value\": \"API\",\n \"timestamp\": 1419968066626,\n \"sourceVid\": [\n \n ]\n }\n ]\n }\n }\n },\n \n }\n],\n\"hasMore\": false,\n\"offset\": 4,\n\"total\": 4\n}"
The number of records to return in a single request. Supports values up to 100.
Each response will include a hasMore
value and an offset object. If hasMore
is true
, then you would use the offset object in the next request to get the next set of results.
Successful response - This endpoint is used to search for companies by domain name
The response is of type object
.
Was this page helpful?