REST API v7: cannot retrieve parents of a Requirement

Wednesday, October 15, 2025
Avatar

Hello,

I'm trying to retrieve the Requirements parents of a given Requirement.

According to API v7 documentation, the SpiraTeam: REST Web Service should do the job, but it doesn't in practice: the returned error is "Endpoint not found".

 

The GET call, made using Postman:
http://[SPIRATEAM_SERVER]/Services/v7_0/RestService.svc/projects/[PRJID]/requirements/[REQID]/parents?username=[USER]&api-key=[RSSAPIKEY]

All parameters inside brackets are valid, since I get positive results with similar APIs (for example, to get Requirement childrens, a very similar API).

Usually, the error "Endpoint not found" is due to a missing functionality (or calling the wrong API).

 

I didn't found any previous thread about this issue on the forum: can someone help or provide me an hint?

Many thanks in advance,

Gianfranco

7 Replies
Wednesday, October 15, 2025
Avatar
re: GianfrancoMelis Wednesday, October 15, 2025

Dear Gianfranco,

Usually, 'Endpoint not found' error message means that some part of the path or endpoint is incorrect. 

The working API endpoint looks like this: 

GET https://YOUR_INSTANCE.URL/services/v7_0/RestService.svc/projects/1/requirements/17/parents?username=administrator&api-key={1B7850B9-ZYZY-XYXY-ZXZX-5E300EA90AC2}

Please make sure that:
- You keep API-KEY in curly braces (not square brackets)
- ProjectID and RequirementID have no brackets at all
- Username has no brackets

More about using API endpoints can be found here: https://spiradoc.inflectra.com/Developers/API-Overview/#overview

If you will still have issues with that, please contact support directly in a dedicated ticket.

 

Regards,
Victoria -

Wednesday, October 15, 2025
Avatar
re: inflectra.Victoria Wednesday, October 15, 2025

Hi Victoria,

first of all, thanks for your reply.

I deeply investigated and after reading documentation for 3h, I tested the APIs on local system https://My_server_url/Services/v7_0/RestService.aspx  (will produce the list of available API calls)

and I discovered that the SpiraTeam: REST Web Service is not available on our SpiraTeam v7.12.0.0.

Starting from which version the "projects/{project_id}/requirements/{requirement_id}/parents" is available?

 

Thank you very much.

Gianfranco

 

Thursday, October 16, 2025
Avatar
re: GianfrancoMelis Wednesday, October 15, 2025

Dear Gianfranco,

I believe, REST API v7 available from Spira v7.5: https://spiradoc.inflectra.com/About/release-notes-v7/#version-75-march-2023/#:~:text=RQ:4417
The endpoint exists in API v7, there was no similar endpoint for version 6 API.

I would upgrade Spira up to the latest, but if you'd like to know the exact version of Spira - let me check and get back to you.

 

Regards,
Victoria -

Thursday, October 16, 2025
Avatar
re: inflectra.Victoria Thursday, October 16, 2025

Hi Victoria,

yes please.

In the mean time will try to create a different implementation for parsing the tree.

 

Many thanks for your precious support!

 

g.

Thursday, October 16, 2025
Avatar
re: GianfrancoMelis Thursday, October 16, 2025

Dear Gianfranco,

So, the endpoint was introduced first in Spira version 8.9 - so you need to upgrade to use this functionality.
More details about that can be found here: https://spiradoc.inflectra.com/About/release-notes-v8/#:~:text=IN:10747

The documentation about the endpoint will be available in Spira -> Admin menu -> Integration -> WebServices after upgrading to v8.9

 

 

Regards,
Victoria -

Thursday, October 16, 2025
Avatar
re: inflectra.Victoria Thursday, October 16, 2025

Hello Victoria,

thank you so much for your support.

 

Regards,

g.

Friday, October 17, 2025
Avatar
re: GianfrancoMelis Thursday, October 16, 2025

Dear Gianfranco,

Thank you for your feedback.

Glad the issue has been resolved.

 

Regards,
Victoria -

Spira Helps You Deliver Quality Software, Faster and With Lower Risk

And if you have any questions, please email or call us at +1 (202) 558-6885

 

Statistics
  • Started: Wednesday, October 15, 2025
  • Last Reply: Friday, October 17, 2025
  • Replies: 7
  • Views: 68