REST API Reference

Back Next

REST API responses

A successful REST API response returns the requested object, an array of objects, or an HTTP success code. A failed response returns an HTTP error code and can also return an error object.

Successul responses

The following table describes common successful responses to REST API requests:

Request type	Response
GET	For an information request, returns the requested object or an array of objects when applicable. For an action request, returns the HTTP 200 success code. Can also return the REST API success object.
POST	Returns the object that you created or updated. Can also return the HTTP 201 success code.
DELETE	HTTP 200 success code. Can also return the REST API success object.

For example, if you use a GET request to view a schedule, a successful response is the schedule object that you requested. Or, if you use a POST request to update the time that the schedule runs, a successful response is the schedule object that you updated, including the update. If you use a DELETE request to delete a schedule that is no longer being used, a successful response is the 200 success code.

Failed responses

For a failed response, the REST API returns a standard HTTP error code and can also return an error object. The following table describes some of the HTTP error codes that might be returned:

HTTP error code	Description
400	Bad request. Can be a field or format issue such as an invalid character or incorrect string length.
401	Authentication issue. For example, invalid credentials or invalid session IDs.
403	Generic error. For example, user doesn't have required permissions for a resource.
404	Resource can't be found.
500	Unexpected error. Generic error message that appears when an unexpected condition was encountered.
502	Network issue.
503	Service unavailable. The server cannot handle the request.

Informatica Intelligent Cloud Services REST API

Download Guide

Watch

Comments

Cloud Data Integration Homepage

0 COMMENTS

We’d like to hear from you! Log in to comment.

Detlef Werner - November 10, 2022

This list of responsecodes seems to be incomplete. E.G. the post call on the loginUrl returns also a HTTP 400 is the password is wrong, not a 403!

Informatica Documentation Team - November 11, 2022

Hi Detlef. We’re working to address your comments and will get back to you.

Informatica Documentation Team - November 15, 2022

Hi Detlef. We're adding more information about the HTTP error codes in an upcoming release.

Thanks,

Informatica Documentation team

Manish Kumar - June 09, 2023

Could you please suggest how can we capture this response status code for any API instead of actual response. For example, if a get method is requested, i just want to capture 200/400 or whatever the response code?

Informatica Documentation Team - June 10, 2023

Hi Manish. Thanks for your comment. We're reviewing it and will get back to you.

Informatica Documentation Team - June 21, 2023

Hi Manish. Our development team suggests that you consult the documentation for the REST client that you're using for the best answer since this is a question about HTTP standards. You can also contact Informatica Global Customer Support.

Rename Saved Search

Table of Contents

REST API Reference

REST API Reference

REST API responses

REST API responses

Successul responses

Failed responses